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1.  INTRODUCTION 


This  manual  describes  SAMM,  a  new  moderate  spectral  resolution  (2  cm'^)  infrared 
(IR)  atmospheric  transmission  and  background  radiance  model  applicable  at  altitudes  from 
ground  to  space  (300  km).  SAMM,  SHARC^^^  And  MODTRAN^^’^^  Merged,  was  developed 
by  integrating  the  DOD  standard  lower  atmosphere  (2  cm'^  MODTRAN)  and  upper 
atmosphere  (1  cm'^  SHARC)  moderate  spectral  resolution  models  into  a  single,  seamless  code 
with  a  unified  and  correlated  radiative  transport  algorithm.  This  manual  provides  an  overview 
of  the  SAMM  model  and  describes  how  to  mn  SAMM  by  providing  code  implementation  and 
execution  instructions.  It  also  discusses  the  newly  developed  radiative  transport  algorithm 
which  is  applicable  to  both  the  low  and  high  altitude  regimes.  Frequent  references  are  made  to 
the  SHARC,(^>  MODTRAN,(2>  LOWTRAN  (precursor  to  MODTRAN),  and  SAG^^) 
(SHARC/SAMM  Atmospheric  Generator)  manuals  to  avoid  repetition  of  phenomenological 
descriptions,  file  definitions,  and  input  instructions  for  users  already  familiar  with  these  codes; 
it  is  helpful  to  have  copies  of  these  manuals  on  hand  when  initially  implementing  and/or 
running  SAMM. 

SAMM  has  five  primary  modules. 

•  INPUT  -  an  expanded  SHARC  interactive  input  module  defines  file  & 
directory  names,  extended  &  local  environments,  lines-of-sight  (LOS), 
spectral  bandpass  parameters,  and  molecular  radiators; 

•  CHEMKIN  -  the  SHARC  kinetics  package  solves  input  chemical 
equations  to  determine  excited  state  vibrational  populations  in  both 
ambient  and  auroral  regions; 

•  REFGEOM  -  upgraded  MODTRAN  refractive  geometry  routines  track 
altitude,  latitude,  and  longitude; 

•  COLDEN  -  a  new  SAMM  module  calculates  all  optical  and  solar  path 
column  densities  by  combining  MODTRAN  low  altitude  column  amounts 
with  high  altitude  amounts  determined  through  repeated  calls  to  SHARC 
geometry  routines;  and 

•  RAD  -  a  modified  MODTRAN  radiative  transfer  routine  calculates 
spectral  radiances  and  transmittances  using  a  combined  line-by-line  (LBL) 
and  band  model  equivalent  width  algorithm. 
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SAMM  input  and  output  files  are  a  combination  of  those  used  by  SHARC  and  MODTRAN, 
with  some  relevant  modifications.  This  manual  includes  a  description  of  the  various  files. 
Appendices  contain  implementation  instructions,  details  about  the  source  code,  sample  input 
and  output  files,  and  derivation  of  an  upgrade  made  to  MODTRAN ’s  column  density 
calculations. 
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2.  OVERVIEW 


SAMM  is  a  model  for  predicting  spectral  radiances  for  selected  lines-of-sight  (LOS) 
through  the  atmosphere.  This  section  presents  an  overview  of  the  model,  describing  problem 
set  up,  code  structure,  and  general  approach. 

2.1  The  INPUT  Module 


The  INPUT  module  defines  the  problem  to  be  solved.  More  specifically,  the  module  is 
used  to  set  up  an  earth’s  atmosphere,  to  fix  solar  position,  and  to  select  the  set  of  LOS  and 
spectral  bandpasses  over  which  radiances  are  to  be  predicted. 

In  SAMM,  the  earth’s  atmosphere  from  0  to  300  km  altitude  is  partitioned  into  a  single 
extended  ambient  region  and  localized  ambient  and/or  auroral  sub-regions.  The  aurora  are 
regions  whose  chemistry  is  influenced  by  the  bombardment  of  solar  electrons;  specification  of 
the  incident  electron  energy  spectrum  and  its  duration  is  required  for  modeling  these  aurora. 
Both  ambient  and  auroral  localized  regions  are  bounded  by  surfaces  of  constant  altimde, 
latitude,  and  longitude.  Within  each  region,  the  user  may  define/select  either  a  single  set  of 
pressure,  temperature,  and  total  molecular  density  profiles  or  multiple  sets,  each  one 
associated  with  a  particular  solar  earth  center  angle  (solar  earth  center  angle  is  used  rather  than 
solar  zenith  angle,  because  the  former  is  not  affected  by  spherical  refractive  geometry  and 
therefore  is  altitude  independent  at  a  fixed  latitude  and  longimde). 

The  SAMM  input  module  allows  the  user  to  select  the  number  of  regions,  their 
boundaries,  and  their  profiles.  Two  generic  atmospheric  profile  files  are  supplied  with  the 
code  (MIDLAT.DAY  and  MIDLAT.NIG)  along  with  terminator  profiles  for  O3 
(T4Z091.ATM,  T4Z093.ATM,  T4Z095.ATM,  T4Z097.ATM,  T4Z099.ATM,  T4Z101.ATM 
&  T4Z102.ATM)  and  CO2  (T5Z091.ATM,  T5Z094.ATM,  T5Z097.ATM,  T5Z099.ATM, 
T5Z102.ATM,  T5Z104.ATM  &  T5Z108.ATM).  Additional  atmospheric  profiles  can  be 
generated  using  the  SAG^^^  (SH ARC/S AMM  Atmospheric  Generator)  program. 

Aerosol  profiles  are  not  defined  in  the  atmospheric  profile  files,  but  instead  are  defined 
in  an  external  file  named  HAZE.INP;  these  profiles  are  input  using  the 
MODTRAN/LOWTRAN  7  format,  and  they  must  be  entered  or  modified  by  directly  editing 
HAZE.INP. 

Solar  position  is  specified  either  by  directly  entering  solar  latimde  and  longimde  or  by 
selecting  year,  month,  day,  and  Greenwich  mean  time. 
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There  are  three  basic  LOS  types:  observer-to-source,  observer-to-space,  and  limb 
viewing.  For  both  the  observer-to-source  and  the  observer-to-space  paths,  the  observer 
location  is  defined  by  entering  the  observer  altitude,  latitude,  and  longitude.  There  are  five 
options  for  specifying  source  location;  input  (1)  source  altitude  and  observer  zenith  &  azimuth, 
(2)  path  range  and  observer  zenith  &  azimuth,  (3)  source  altimde,  path  range,  and  observer 
azimuth,  (4)  source  altitude,  path  earth  center  angle,  and  observer  azimuth,  or  (5)  source 
altitude,  latitude  &  longitude.  For  paths  to  space,  the  observer  altimde,  and  either  the 
observer  zenith  or  the  tangent  altimde  must  be  input.  Limb  viewing  LOS  are  tangent  paths 
extending  from  space  to  space;  these  paths  are  specified  by  entering  the  tangent  point  altimde, 
latimde,  longimde  &  azimuth.  For  all  paths,  azimuth  angles  can  be  specified  either  by  directly 
entering  the  angle  (degrees  East  of  North)  or  by  entering  a  latimde  and  longimde  in  front  of  or 
behind  the  observer  (tangent  point  for  limb  paths)  location. 

All  spectral  data  are  entered  in  wavenumber  (cm’^)  units.  The  spectral  range  of 
SAMM  is  250  to  10,000  cm‘^  and  the  minimum  spectral  resolution  is  1  cm'^ 

2.2  The  CHEMKIN  Module 


The  CHEMKIN  module  determines  the  distribution  of  the  excited  vibrational  states 
under  non-local  thermodynamic  equilibrium  (non-LTE)  conditions.  At  low  altimdes,  the  time 
step  for  collisional  excitation/relaxation  processes  is  short,  LTE  conditions  prevail,  and  the 
population  of  vibrational  states  follow  a  Boltzmann  distribution.  Spontaneous  emission, 
chemiluminescent,  and  solar/thermal  pumping  processes  compete  with  collisional 
excitation/relaxation  at  lower  pressures.  To  predict  vibrational  state  populations  under  these 
non-LTE  conditions,  the  pertinent  chemical  kinetic  equations  must  be  solved  explicitly. 

The  profiles  discussed  in  the  previous  section  define  the  total  molecular  densities  as  a 
function  of  altimde  in  the  SAMM  regions.  Dominant  radiators  below  30  km  altimde  are  LTE. 
The  CHEMKIN  module  is  used  to  determine  vibrational  state  distributions  between  30  and 
300  km  altimde.  For  each  radiating  species,  a  chemical  mechanism  (a  series  a  chemical 
equations)  is  input  to  SAMM.  Default  kinetics  files  are  supplied  with  the  SAMM  source. 
SAMM  initially  calculates  solar  and  earthshine  excitation  rates.  In  ambient  regions,  the  steady 
state  solutions  to  the  kinetic  mechanisms  are  then  determined  layer-by-layer;  for  auroral 
regions,  the  time  dependent  chemical  kinetic  equations  are  solved.  The  resulting  populations 
are  then  adjusted  to  account  for  self  absorption. 
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2.3  The  REFGEOM  Module 


The  REFGEOM  module  tracks  all  required  refractive  paths  for  SAMM.  The  basic 
refractive  geometry  equation  is 

Hr  R  sin0  =  constant  (1) 

where  R  is  the  earth  center  distance,  nj^  is  the  real  part  of  the  refractive  index,  and  B  is  the 
zenith  angle  at  R.  The  assumption  is  made  that  the  refractive  path  varies  insignificantly  with 
wavelength,  and  refractive  geometry  calculations  are  performed  for  the  central  frequency  of 
the  spectral  bandpass  only.  A  second  assumption  is  that  the  refractive  index  is  constant  above 
30  km  i.e.,  at  low  pressures,  and  straight  line  geometry  is  used  for  the  30  to  300  km  altitude 
region. 

Refractive  paths  are  tracked  by  marching  along  from  the  initial  location  to  the 
termination  point.  It  is  necessary  that  the  altitude,  latitude,  longitude,  path  zenith,  and  path 
azimuth  at  the  initial  location  all  be  known.  If  this  LOS  starting  point  information  is  not  actual 
input  (e.g.,  if  path  range  instead  of  zenith  angle  is  used  to  specify  an  observer-to-source  path), 
then  the  REFGEOM  modules  solves  for  the  required  initial  data,  directly  if  possible  and 
iteratively  when  necessary. 

Output  from  the  REFGEOM  module  includes  coliunn  densities  and  layer  averages  for 
both  optical  and  scattering  point-to-sun  paths  below  30  km.  A  new  algorithm  has  been 
developed  to  calculate  these  quantities  directly  from  the  layer  path  length  and  boundary  zenith 
angles,  altitudes,  and  densities.  The  approach  is  described  in  Appendix  H. 

2.4  The  GOLDEN  Module 


The  GOLDEN  module  merges  column  density  information  from  the  MODTRAN  and 
SHARG  sections  of  the  code.  The  MODTRAN  section  of  the  code  determines  all  the  lower 
altitude  (<  30  km)  total  molecular  column  densities;  for  radiators  common  to  both 
MODTRAN  and  SHARG  (H2O,  GO2,  GO,  NO,  O3  &  GH4),  densities  must  be  partitioned  into 
their  vibrational  states.  At  higher  altimdes,  the  SHARG  column  densities  must  be  combined 
with  the  MODTRAN  path  amounts  for  HNO3,  SO2,  NO2,  NH3,  N2O,  O2,  and  the  aerosols. 

Unfortunately,  MODTRAN  and  SHARG  use  different  conventions  for  molecular 
indices.  SAMM  combines  the  labeling  schemes  and  places  all  the  column  density  information 
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for  the  optical  path  into  a  single  array  (VPATH).  A  second  array  (VPATHS)  contains  all  the 
column  density  data  for  scattering  point-to-sun  paths. 

2.5  The  RAD  Module 


The  RAD  module  is  a  modification  of  the  MODTRAN  radiative  transport  routines,  and 
calculates  and  outputs  spectral  radiances.  The  spectral  bandpass  is  sampled  in  1  cm  ^  steps. 
The  resulting  1  cm'^  data  is  internally  degraded  using  a  digitized  triangular  slit  function  if  the 
user  requests  a  FWHM  (Full  Width  at  Half  Maximum)  in  excess  of  1  cm‘^  (FWHM  must  be  a 
positive  integer  no  greater  than  50). 

For  each  frequency,  there  is  a  loop  over  the  optical  path  layers  to  determine  their 
contribution  to  the  spectral  radiance.  Single  scatter  solar/lunar  radiance  is  included  in  the 
layer  radiances  by  considering  the  contribution  from  L-shaped  paths  from  the  sun/moon  to  the 
layer  to  the  observer.  The  multiple  scattering  contribution  to  the  spectral  radiance  is 
determined  by  initially  performing  a  two-flux  calculation  at  each  frequency;  the  required 
upward  and  downward  fluxes  are  calculated  by  looping  over  the  atmospheric  layers  below  100 
km  using  a  vertical  path  from  ground  to  space.  Details  of  the  radiance  algorithm  are  presented 
in  Section  3. 
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3.  RADIATION  TRANSPORT  ALGORITHM 


In  the  lower  atmosphere,  below  30  km  altitude,  collisional  processes  dictate  the 
distribution  of  the  dominant  vibrationally  excited  species,  i.e.,  LTE  conditions  prevail.  At 
higher  altitudes,  where  densities  are  much  lower,  radiative  pumping  and  spontaneous  emission 
processes  can  begin  to  compete  with  the  collisional  processes.  The  deviation  from  LTE 
depends  on  details  of  the  excitation  reactions  and  varies  from  one  molecular  band  to  another. 
When  the  ambient  temperature  no  longer  describes  the  distribution  of  vibrationally  excited 
states,  a  molecular  band  is  said  to  be  in  non-local  thermodynamic  equilibrium  (non-LTE). 
Transmittances  and  radiances  then  depend  explicitly  on  these  vibrational  distributions. 

3 . 1  Line-of-Sisht  Radiance 


Computation  of  the  spectral  radiance  for  an  atmospheric  line-of-sight  (LOS)  passing 
through  both  the  LTE  and  non-LTE  regimes  requires  detailed  information  about  gas  kinetic 
temperature,  pressure,  species  column  densities,  vibrational  populations,  solar  irradiance,  and 
surface  temperature.  SHARC  calculates  these  radiances  by  modeling  non-LTE  formation 
processes  and  then  performing  LBL  calculations,  while  MODTRAN  uses  an  LTE  band  model 
approach.  SAMM  has  adopted  a  hybrid  approach  in  which  the  SHARC  radiators  (CO2,  H2O, 
O3,  CO,  OH,  CH4,  NO,  &  NO"^)  are  treated  LBL  and  all  other  emitters  (N2O,  O2,  SO2, 
NO2,  NH3,  HNO3,  &  continuum  sources)  are  modeled  using  the  MODTRAN  band  model 
techniques.  The  LOS  is  represented  as  a  series  of  segments,  and  the  radiance  within  each  (1 
cm'^)  spectral  bin  is  calculated  as  the  sum  of  emission  I®,  single  scattering  T*,  and  multiple 
scattering  terms: 

I  =  ^  I?  +  If  -i-  If'  ,  (2) 

i 

where  the  sum  is  over  the  atmospheric  layers  traversed  by  the  LOS.  The  emission  from  each 
layer  is  calculated  as  a  product  of  the  incremental  transmittance  T(,i  -  t^,  one  minus  layer 
scattering  albedo  l-w^,  and  a  source  term  R^: 

I?  =  (7f.i  -  T^)  (l-co^)  R^  .  (3) 
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The  t£  are  the  transmittances  from  the  observer  to  the  far  side  of  layer  L  These  calculations 
are  done  at  each  wavenumber  or  spectral  bin  increment.  Since  MODTRAN  is  an  LTE  model, 
its  source  term  is  simply  the  Planck  blackbody  function.  SAMM  models  both  LTE  and 
non-LTE  radiators  by  defining  the  source  term  as  an  average  over  the  individual  sources  (j) 
weighted  by  their  incremental  spectral  bin  equivalent  widths,  AW^j  (=  W^j  -  W^.j  j): 


R.  = 


TC 


E 


AW,j  ( 


Pi] 


Pl]-Pi] 


7)  / 


E 


AW,j 


(4) 


where  c^  is  the  first  radiation  constant  (Cj  =  2irhc^,  h  is  the  Planck  constant  and  c  is  the  speed 
of  light),  V  is  the  spectral  bin  frequency,  and  are  the  densities  of  the  upper  &  lower 

states,  respectively.  The  sources  of  emission  being  summed  over  include  SHARC  molecular 
transitions,  MODTRAN  band  model  lines  for  non-SHARC  species,  and  the  MODTRAN 
continuum  sources.  This  expression  for  the  source  term  reduces  to  the  blackbody  function 
under  LTE  conditions,  is  exact  in  the  weak  line  limit,  and  gives  greatest  weight  to  the 
strongest  absorber  in  a  given  layer  along  the  LOS.  The  equivalent  width  for  each  spectral  bin 
is  defined  as  a  species’  absorption  within  that  bin  and  is  given  by 


W^j  =  J  dj'  [1  -  Tfj(0]  ,  (5) 

Ay 

where  is  the  spectral  transmission  through  layer  £  for  absorber  j  and  Av  is  the  width  of  the 
spectral  bin. 

The  spectrally  averaged  transmission  arising  from  an  ensemble  of  absorbers  centered 
randomly  within  the  spectral  interval  is  given  by 


(6) 


This  equation  implicitly  includes  the  statistical  correction  for  random  line  overlap. Both  the 
single  line  and  band  model  equivalent  widths  for  a  Voigt  lineshape  are  evaluated  using  the 
Rodgers  and  Williams^^’’^^  (RW)  interpolation  formula.  This  formula  has  been  shown  to  give  a 
peak  error  of  8%.  The  Lorentzian  line  tails  are  subtracted  from  the  RW  expression  to  obtain 
the  Voigt  equivalent  width  within  a  spectral  bin.^^’^^  This  correction  is  important  for  lower 
altitudes  where  the  total  equivalent  width  of  a  strong  line  can  easily  exceed  the  t>q)ical  bin 
width  of  1  cm'^  The  RW  interpolation  formula  requires  evaluation  of  equivalent  widths  in  the 
Lorentz,  Doppler,  and  weak-line  limits.  Standard  approximations^^)  in%olving 
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Curtis-Godson^^’^^  path  averages  are  used  to  evaluate  these  widths.  Curtis-Godson  path 
averages  are  used  to  approximate  paths  through  multiple  layers  by  a  single  homogeneous  path. 

An  upgraded  formulation  for  the  single  scattering  solar  radiance  has  been  integrated 
into  both  MODTRAN  and  SAMM.  The  single  scatter  component  can  be  written 


'set  e-1 


tSS 


=  J  4^  T'absW  dr 


'set  f 


(7) 


is  the  extraterrestrial  solar  flux  and  is  the  scattering  phase  (angular  cross-section) 
function.  Since  the  variation  in  scattering  angle  along  the  LOS  is  negligible,  a  layer  averaged 
phase  function  can  be  factored  out  of  the  integral.  The  question  remains  as  to  how  the  L 
shaped  path  (observer  to  scattering  point  to  sun)  transmittance  from  absorption  t  ^bs  varies  with 
the  LOS  scattering  transmittance.  In  deriving  an  expression  for  the  layer  thermal  emission, 
Comette^^®^  assumed  that  transmission  from  absorption  and  scattering  both  varied 
exponentially  across  a  layer.  This  is  equivalent  to  Minschwaner’s  assumptions^ of  equal 
effective  absorption  and  scattering  scale  heights  within  a  layer.  We  similarly  assume  that 


abs  £-1 


|-  e  y, 

^^abs  t’-l 


where 
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In  [  T  /  Tset  ] 

[  “^set  ?  ^  ^set  f-1  ] 


(9) 


With  this  assumption,  the  single  scatter  solar  integral  can  be  evaluated  analytically  yielding 
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SS 

£ 


psun 
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ln( 


^sci  £-1  ^ 
^set  £ 


In  [  rL^.i  /T^i  ] 


(10) 


The  first  logarithm  term  equals  the  layer  scattering  optical  depth,  and  the  final  term  can  be 
interpreted  as  an  averaged  L  shaped  path  total  transmittance  divided  by  the  extinction 
(absorption  plus  scattering)  layer  optical  depth. 

In  MODTRAN  and  hence  SAMM,  the  molecular  and  aerosol  single  scatter  solar 
radiance  contributions  are  treated  separately.  The  total  single  scatter  solar  radiance  is  a  sum  of 
the  two  terms.  Three  choices  are  available  for  the  aerosol  phase  function:  user-supplied, 
Henyey-Greenstein,  or  Mie  generated  internal  database,^^!  CARDS  3A1  and  3A2  of  the 
MODTRAN/LOWTRAN  7  input  stream. The  L  shaped  path  transmission  terms,  are 
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calculated  for  all  the  SHARC  and  MODTRAN  absorbers,  rigorously  determining  the  column 
density  through  the  multiple  higher  altitude  regions. 

The  MODTRAN  LTE  treatment  of  multiple  scattering 

ir  =  ,  (11) 

has  not  been  altered  because  multiple  scattering  is  only  significant  at  the  lower  altitudes  where 
LTE  conditions  prevail.  At  each  layer  boundary,  the  upward  and  downward  fluxes,  Ff ,  the 
scattering  albedo,  oj^,  and  the  backscatter  fraction,  are  calculated.  The  two  flux 
calculation,  which  uses  a  vertical  path,  is  performed  for  the  atmosphere  defined  at  the 
observer’s  latitude  and  longitude  and  with  its  high  altitude  boundaries  fixed  at  30,  35.  40,  45, 
50,  70,  and  100  km;  multiple  scattering  is  not  included  above  100  km.  When  multiple 
scattering  is  not  requested,  the  scattering  albedo  in  Equations  (3)  and  (11)  is  set  to  zero. 

3.2  Low  Altitude  Solar  Attenuation 

Since  SHARC-3,  MODTRAN  and  SAMM  calculate  LOS  radiances  in  the  region  of  the 
solar  terminator,  solar  zenith  angles  that  are  greater  than  90°  must  be  accommodated.  Under 
these  conditions,  the  solar  irradiance  passes  through  parts  of  the  atmosphere  that  are  below  the 
lower  boundary  of  the  chemical  kinetics  module  (50  km  in  SHARC-3,  30  km  in  SAMM). 
Since  some  of  this  radiation  is  absorbed  by  the  lower  atmosphere,  its  intensity,  and  spectral 
structure  are  modified.  The  amount  of  absorption  at  any  wavenumber  is  a  function  of  the  solar 
zenith  angle,  or  equivalently  the  minimum  altitude  through  which  the  sunlight  passes,  and  of 
the  aerosol  and  molecular  content  of  the  lower  atmosphere. 

SHARC-3  and  SAMM  distinguish  the  attenuation  of  solar  irradiance  by  "line  center" 
and  "continuum"  sources.  Both  codes  model  the  line  center  attenuation  of  solar  irradiance  by 
performing  LBL  calculations  for  each  vibrational  transition.  They  use  an  approximate 
distribution  of  lines  from  a  BANDS  file  (Section  6.3  of  the  SHARC  3  Manual)^^^  to  describe 
each  transition.  Curtis-Godson  averages  are  used  to  define  Doppler  and  collision  broadened 
half- widths  for  the  solar  paths.  The  "continuum"  sources  here  denote  all  sources  of  absorption 
other  than  the  particular  vibrational  band  under  consideration. 

In  SHARC-3  lower  atmosphere  continuum  transmittances  and  Curtis-Godson  sums  are 
pre-stored  for  three  fixed  aerosol  profiles  and  for  one  fixed  molecular  profile  (derived  from  the 
US  Standard  Atmosphere).  Since  SAMM  input  includes  profile  information  for  the  lower 
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atmosphere,  the  continuum  transmittances,  and  Curtis-Godson  sums  are  calculated  as  needed 
by  making  the  necessary  calls  to  MODTRAN.  Thus,  the  solar  attenuation  is  sensitive  to 
variations  in  aerosol  and  cloud  conditions. 
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4.  RUNNING  SAMM 


This  section  serves  as  a  reference  for  the  user  who  wants  to  get  SAMM  running 
without  making  modifications  to  the  kinetics  supplied  with  the  code.  The  instructions  are 
written  assuming  SAMM  is  being  installed  on  a  UNIX  based  system;  some  adjustments  are 
necessary  for  PC  installations.  The  required  files  and  auxiliary  programs  are  discussed, 
allowing  preparation  for  the  first  run.  The  menu  system  used  by  the  INPUT  module  to 
communicate  with  the  user  is  outlined  in  some  detail.  If  modifications  to  the  kinetics  files  are 
required,  the  user  should  read  Sections  6  and  7  of  the  SHARC-3  manual. 

4.1  Data  File  Preparations  for  Running  SAMM 

The  specific  tasks  which  must  be  completed  before  initially  running  SAMM  are: 

•  compile  interp.f  to  create  the  executable  interp,  and  run  the  command  file 
interp.run  to  create  the  link  files  containing  the  chemical  kinetic  schemes; 

•  compile  and  run  dirac.f  to  create  the  lines  file  SHARC.H92  (must  be 
created  even  if  a  SHARC-3  lines  file  already  exists  because  the  files  have 
different  access); 

•  compile  and  run  ufinake.f  to  create  the  band  model  parameter  file 
UFTAPE  and  the  subroutine  samblk.f;  and 

•  move  samblk.f  into  the  source  directory,  and  compile  the  SAMM  source. 

After  completing  these  steps,  a  user  can  perform  basic  SAMM  runs.  Additional  preparations 
are  required  if  the  user  wishes  (1)  to  use  atmospheric  profiles  other  than  those  supplied  with 
the  code,  (2)  to  include  aerosol  profiles,  or  (3)  to  define  scattering  phase  functions  other  than 
those  internal  to  the  code.  This  section  describes  all  the  above  preparations. 

4.1.1  NECESSARY  DATA  FILES 

Prior  to  any  SAMM  calculation,  kinetic  "linking"  files  must  be  created.  This  is 
accomplished  by  running  the  INTERPRETER  once  for  each  radiator;  the  command  file 
interp.run  can  be  used  to  perform  these  multiple  run  of  the  INTERPRETER  in  a  single  step. 
The  INTERPRETER  reads  chemical  equations  and  rate  constant  information.  The  procedure 
is  detailed  in  Section  7.1  of  SHARC-3  manual;^^^  the  result  is  binary  linking  files  for  each 
radiator.  As  discussed  below,  these  files  and  their  associated  states  and  bands  files  need  not  be 
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in  the  same  directory  as  the  executable  version  of  SAMM;  rather,  they  can  be  placed  in  a 
separate  kinetics  directory  for  convenience.  Indeed,  these  files  can  be  shared  with  a 
stand-alone  version  of  SH ARC-3. 

The  LBL  calculations  in  SAMM  are  performed  using  the  SH  ARC-3  lines  file:  this  file 
contains  line  parameters  from  HITRAN92  along  with  auxiliary  data  for  hot  O3,  NO,  and 
NO'*'.  The  SAMM  band  model  calculations  use  data  from  the  MODTRAN  band  model 
parameter  tape.  Both  these  data  files  must  be  converted  to  binary  for  use  by  SAMM.  Note 
that  even  though  the  SAMM  ascii  data  files  are  identical  to  the  ascii  versions  from  SHARC 
and  MODTRAN,  the  binary  files  are  different  and  presently  can  not  be  used  interchangeably. 

The  direct-access,  binary  file  SHARC.H92  is  created  from  the  sequential,  formatted 
SHARC. ASC  file  by  compiling  and  executing  the  dirac.f  FORTRAN  program.  The  large 
SHARC. ASC  file  can  be  deleted  once  SHARC. H92  has  been  created  (if  needed,  SHARC. ASC 
can  be  regenerated  from  SHARC.H92  by  running  program  linasc.f).  A  copy  of  the 
FORTRAN  block  data  file  RECDAT.f  is  also  created  when  dirac.f  is  run.  Routine 
RECDAT.f  is  already  included  in  modblk.f  and  does  not  have  to  be  integrated  into  SAMM. 

The  direct-access,  binary  band  model  parameter  file  UFTAPE  is  created  by  compiling 
and  executing  the  ufmake.f  FORTRAN  program.  UFTAPE.ASC  can  be  deleted  once 
UFTAPE  has  been  created  (if  needed,  UFTAPE.ASC  can  be  regenerated  from  UFTAPE  and 
samblk.f  by  running  program  bmasc.f).  SAMM  requires  that  UFTAPE  and  SHARC.H92  be 
stored  in  the  same  directory. 

The  program  ufmake.f  also  creates  the  block  data  routine  samblk.f.  This  block  data 
contains  a  data  statement  defining  LREC,  the  logical  record  length  used  to  create  LTTAPE. 
Since  the  value  of  LREC  is  machine  dependent,  samblk.f  must  be  moved  to  the  directory 
containing  the  SAMM  source  code.  No  version  of  samblk.f  is  delivered  with  the  source  to 
avoid  use  of  an  incorrect  logical  record  length! 

4.1.2  OPTIONAL  DATA  FILES 

As  noted  in  Section  2.1,  the  SAMM  tape  contains  a  number  of  default  atmospheric 
profiles.  Additional  profiles  can  be  generated  using  the  SAG  program.  Input  to  this  routine 
includes  temporal,  geographic  location,  and  solar  activity  data.  Best  guess  profiles  in  the 
SAMM/SHARC  format  are  output  and  can  be  used  directly.  A  user  may  input  customized 
profiles,  based  for  example  on  radiosonde  data,  by  creating  an  atmospheric  file  in  the 
SAMM/SHARC  formal.  A  description  of  the  format  of  the  atmospheric  files  is  included  in 
Section  6.6  of  the  SHARC-3  manual^^\  The  SAG  manual^^^  details  the  assumptions  and  data 
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sources  used  in  SAG,  and  provide  user  instructions.  The  user  instructions  for  SAG  are  also 
included  in  Section  7.3  of  the  SHARC-3  usser’s  manual. Note  that  for  SAMM,  input 
atmospheric  profiles  must  extend  all  the  way  to  the  ground. 

The  MODTRAN  parameters  for  selecting  aerosol  profile  models,  including  clouds  and 
rain,  are  input  to  SAMM  through  the  HAZE.INP  file.  If  this  file  does  not  exist,  SAMM  will 
run  assuming  no  aerosols.  HAZE.INP  contains  CARD2,  CARD2A,  CARD2B,  and  CARD2D 
from  the  MODTRAN/LOWTRAN  7  input  file.  Their  format  and  description  are  described  in 
detail  in  Section  3  of  the  LOWTRAN  7  manual. If  aerosols  are  to  be  included,  minimally 
CARD2  is  necessary.  CARD2  assigns  pre-stored  altitude  and  seasonal-dependent  aerosol 
profiles  and  aerosol  extinction  coefficients.  The  optional  aerosol  inputs  are  used  for 
calculations  involving  cirrus  clouds  (CARD2A),  the  Army  Vertical  Stmcture  Algorithm 
(CARD2B),  and  user-specified  attenuation  coefficients  (CARD2D). 

If  a  user  chooses  to  input  a  user-defined  aerosol  phase  function,  the  data  is  input 
through  a  PHASE.INP  file.  PHASE.INP  contains  the  MODTRAN  inputs  CARD3B1  and 
CARD3B2.  The  format  and  description  of  these  inputs  are  described  in  detail  in  Section  3  of 
the  LOWTRAN  7  manual. 

4.2  The  Interactive  Input  Module  -  Modifications  to  SHARC-3 

Once  necessary /optional  input  data  files  have  been  created,  the  user  must  define  the 
calculation  scenario.  The  scenario  is  input  to  SAMM  through  a  SAMM.INP  file.  The 
SAMM.INP  file  has  three  primary  sections.  The  first  section  contains  the  SHARC  inputs  (in 
fact,  a  SAMM.INP  file  can  be  converted  to  a  SHARC-3  input  file  with  only  minor 
modifications;  see  Section  5.2).  The  second  section  of  SAMM.INP  begins  with  the  line 
"CMOS-OO  MOSART  INPUTS;  ..."  and  contains  MOSART  input  information.  MOSART  is 
a  low  altitude  and  backgrounds  code^^^^  that  is  currently  being  integrated  into  SAMM;  since 
this  work  is  not  completed,  the  MOSART  inputs  presently  have  no  effect  on  SAMM 
calculations,  and  this  section  of  SAMM.INP  should  be  ignored.  The  third  and  final  section  of 
SAMM.INP  begins  with  the  line  "CM-00  MODTRAN  INPUTS:  ..."  and  contains 
MODTRAN  input  information  not  already  defined  in  the  SHARC  section  of  the  input  stream. 

The  user  updates  a  SAMM.INP  file  by  running  SAMM  interactively.  If  no 
SAMM.INP  file  is  found,  a  default  SAMM.INP  (TEST  CASE  1)  is  initially  created.  The  user 
then  makes  desired  changes  to  SAMM.INP  by  responding  to  a  menu-query  system.  For  more 
experienced  users,  SAMM  can  be  executed  by  circumventing  the  input  module  and  directly 
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entering  changes  to  the  SAMM.INP  file  with  an  editor.  After  SAMM.INP  has  been 
created/updated,  SAMM  calculations  can  be  performed  in  either  interactive  or  batch  mode. 

A  successful  SAMM  calculation  produces  considerable  output.  The  files  are: 


•  Journal  file  -  "SAMM.LOG" 

•  SAMM  input  file  -  "roomame.INP" 

•  SHARC  general  output  file  -  "rootname.OUT" 

•  Population  files 

•  Spectral  radiance  file  -  "rootname.SPC” 

•  Transmittance  file  -  "rootname.TRN" 

•  Bandpass  file  -  "rootname.RAD" 

•  MODTRAN  input  file  -  "rootname.TP5" 

•  MODTRAN  standard  output  file  -  "rootname.TPb" 

•  MODTRAN  plotting  file  -  "rootname.TP?" 

•  MODTRAN  auxiliary  output  file  -  "rootname.TPS" 


(Section  5.1), 
(Section  5.2), 
(Section  5.3), 
(Section  5.4), 
(Section  5.5), 
(Section  5.6), 
(Section  5.7), 
(Section  5.8), 
(Section  5.9), 
(Section  5.10),  and 
(Section  5.11). 


The  user  can  choose  to  have  the  program  delete  any  of  the  "roomame. extension"  files  prior  to 
completion  to  save  disk  space.  If  no  warnings,  cautions  or  errors  are  written  to  the  journal 
file,  SAMM.LOG  is  deleted  just  prior  to  program  completion.  The  user  should  always  check 
if  the  journal  file  was  saved  and,  in  that  case,  read  it  to  insure  the  calculation  was  performed 
correctly.  During  auroral  calculations,  several  warning  messages  are  given  stating  that 
different  molecular  species  were  not  found.  Since  auroral  excitation  is  only  calculated  for 
CO2,  NO,  and  NO+,  this  is  reasonable,  but  the  user  should  check  that  these  were  not 
inadvertently  omitted  too. 

The  SAMM  input  module  is  derived  from  the  SH ARC-3  input  module.  A  menu-query 
system  walks  the  user  through  the  required  inputs.  In  general,  typing  a  0  or  carriage  return 
will  take  the  user  up  a  level  in  the  menu  system;  otherwise,  the  user  may  input  new 
information  or  enter  a  sub-menu.  When  a  sub-menu  is  entered,  current  values  of  the  input 
variables  are  displayed.  This  allows  the  user  to  scan  the  current  values  and  decide  if  anything 
needs  to  be  changed.  In  this  section,  differences  between  the  SHARC  and  SAMM  input 
modules  will  be  highlighted;  further  details  are  described  in  Sections  4.2  and  4.3  of  the 
SH  ARC-3  manual. 

At  the  start  of  an  interactive  run,  the  top-level  menu  appears,  Figure  1.  Other  than 
header  information,  the  only  difference  between  the  SHARC  and  SAMM  top-level  menus  is 
the  addition  in  SAMM  of  Entry  11.  MODTRAN  PARAMETERS. 
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SH ARC-3  AND  MODTRAN-2  MERGED,  SAMM 
REVIEW  OR  MODIFY  INPUT  PARAMETERS 

1)  TITLE  FOR  CALCULATION 

2)  REGION  DEFINITION 

3)  LOS  GEOMETRY 

4)  SPECTRAL  INTERVAL,  RESOLUTION  AND  SPECIES 

5)  OUTPUT  DATA 

6)  STANDARD  SET-UP  FOR  FILE  NAMES 

7)  INSTALLATION  SETUT 

8)  UPDATE  DEFAULT  FILE  AND  EXIT  FOR  BATCH  EXECUTION 

9)  UPDATE  DEFAULT  FILE  AND  EXIT 

10)  EXIT  WITH  NO  UPDATE  OF  DEFAULT  FILE 

11)  MODTRAN  PARAMETERS 

ENTER  #  OF  ITEM  TO  BE  CHANGED  OR 
999  TO  CONTINUE  SAMM  EXECUTION 


Figure  1.  The  Top-Level  SAMM  Menu. 


4.2.1  TITLE 

The  SAMM  and  SHARC  title  specifications  are  identical.  A  calculation  may  be  given 
a  title  containing  up  to  68  characters. 

4.2.2  REGION  DEFINITION 

The  REGION  DEFINITION  menus  in  SAMM  and  SHARC-3  (described  in  Section  4.2 
of  the  SHARC-3  manual^  are  identical  with  one  exception.  Each  atmospheric  profile  in  the 
two  codes  is  associated  with  a  fixed  solar  earth  center  angle  (solar  earth  center  angle  is  used 
rather  than  solar  zenith  angle,  because  the  former  is  not  affected  by  spherical  refractive 
geometry  and  therefore  is  altimde  independent  at  a  fixed  latitude  and  longitude).  When  that 
angle  is  between  90.0°  and  107.1984°,  SHARC  requires  a  "LOWER  ATMOSPHERE 
AEROSOL  NUMBER"  which  is  used  to  estimate  the  effect  of  aerosol  attenuation  on  solar 
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irradiances.  Since  SAMM  models  the  lower  atmospheric  attenuation  explicitly,  SAMM  does 
not  require  this  input. 

4.2.3  LOS  GEOMETRY 


The  SAMM  LOS  GEOMETRY  menu,  Figure  2,  differs  from  SHARC-3’s  in  two 
respects.  Entry  2,  the  SUN  LOCATION,  requires  specification  of  the  year  and  outputs  the 
day  of  year,  the  year,  and  the  time  of  day.  The  year  is  used  to  determine  leap  years. 
MODTRAN  uses  the  day  of  year  to  determine  sun-to-earth  distance.  If  solar  angles  are 
directly  input,  SAMM  prompts  the  user  to  select  from  the  two  days  of  the  year  for  which  the 
sun  is  at  the  input  latimde  (there  is  no  prompting  of  the  user  at  the  extrema,  +23.45°  latimde). 
Also,  the  allowed  path  parameters  differ  somewhat  between  SAMM  and  SHARC-3.  Since 
SHARC-3  is  strictly  a  high-altimde  code,  no  LOS  passing  below  50  km  altimde  is  permitted. 


3)  REVIEW  OR  MODIFY  UNE-OF-SIGHT  GEOMETRY 
CURRENT  LOS  DEFINITION: 

1.  COORDINATE  SYSTEM  CENTERED  AT  GEOGRAPHIC  NORTH  POLE 

2.  SUN  LOCATION 

SOLAR  LATITUDE:  0.00  DEG  NORTH 

SOLAR  LONGITUDE:  0.00  DEG  EAST  OF  GREENWICH 

DAY  OF  YEAR:  80  (MAR  21,1993) 

GREENWICH  MEAN  TIME:  0.061  (Decimal  Hours) 

3.  SPHERICAL  EARTH  ASSUMED 

4.  ABSOLUTE  LOS  LOCATION  SPECIFICATION 

DIRECT  INPUT  OF  LATITU'DE/LONGITUDE  INFORMATION 

5.  PATH  TYPE  IS  LIMB  VIEWING  PATH 
TANGENT  POINT  INFORMATION 

TANGENT  HEIGHT:  10.00  KM 

TANGENT  LONGITUDE:  0.000  DEGREES  EAST  OF  GREENWICH 

TANGENT  LATITUDE:  0.000  DEGREES  NORTH 

LOCAL  AZIMUTH  AT  TANGENT  POINT 
AZIMUTH  ANGLE:  0.000  DEGREES  EAST  OF  NORTH 

ENTER  #  OF  ITEM  TO  CHANGE  OR 
0  TO  CONTINUE 


Figure  2.  LOS  GEOMETRY  Sub-Menu. 
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SAMM  allows  LOS  down  to  the  ground.  If  the  input  path  intersects  the  earth,  the 
radiance/transmission  calculation  is  performed  for  the  path  terminating  at  the  earth's  surface. 
SAMM  does  not  support  the  MODTRAN  ITYPE=1  option,  a  homogeneous  horizontal  path. 

Three  additional  points  should  be  made  regarding  the  LOS  geometry: 

(1)  Upon  exiting  from  the  LOS  section  of  the  interactive  module,  a 
"SUMMARY  OF  LINE-OF-SIGHT  GEOMETRY"  is  written  to  the  screen. 

This  information  is  provided  to  enable  the  user  to  check  inputs,  but  the 
displayed  calculated  parameters  are  determined  using  straight  line  geometry 
(once  inputs  have  been  set,  SAMM  calculates  column  densities  using 
spherical  refraction  geometry  and  the  user-specified  LOS  parameters). 

(2)  SAMM,  unlike  SH ARC-3,  does  not  give  a  warning  if  the  selected  LOS 
does  not  pass  through  a  local  (auroral  or  ambient)  region.  Even  if  a  LOS 
misses  a  local  region,  the  region  can  influence  observed  radiance  if 
intersected  by  single  scatter  solar  paths. 

(3)  SHARC-3  and  MODTRAN  use  different  conventions  for  describing 
longitude.  SHARC-3  measures  longitude  in  degrees  East  of  Greenwich, 
while  MODTRAN  longimdes  are  in  degrees  West  of  Greenwich.  SAMM 
explicitly  prompts  for  longitudes  in  degrees  East  of  Greenwich. 


4.2.4  SPECTRAL  INTERVAL,  RESOLUTION,  AND  SPECIES 


If  Entry  4  is  selected  from  the  top-level  menu.  Figure  1,  the  SPECTRAL  INTERVAL, 
RESOLUTION  AND  SPECIES  sub-menu.  Figure  3,  is  displayed.  This  menu  differs  from  the 
SHARC  version  in  that  all  frequency  inputs  are  integers.  In  fact,  the  spectral  interval 
minimum  and  maximum  must  be  multiples  of  5 ,  and  the  highest  resolution  available  is  1  cm  ^ . 
Resolution  is  defined  as  in  MODTRAN,  equal  to  the  FWHM  (Full  Width  at  Half  Maximum) 
for  a  triangular  slit  created  from  rectangular  1  cm"^  bins.  The  SPECTRAL  INTERVAL, 
RESOLUTION  AND  SPECIES  sub-menu  has  one  new  input.  Entry  5  prompts  for  output  step 
size.  This  input  allows,  for  example,  one  to  select  a  2  cm'^  triangular  slit  function  and  have 
radiances  output  each  wavenumber.  Since  SHARC-3  employs  a  non-overlapping  rectangular 
slit  function,  spectral  comparisons  between  SAMM  and  SHARC-3  are  strictly  equivalent  only 
if  resolution  and  step  size  are  set  to  1  cm'^  in  both  codes  (all  test  cases  are  run  with  1  cm  ^ 
resolution  and  step  size).  The  SPECIES  list  selects  which  SHARC  non-LTE  species  are  to  be 
included  in  the  radiance/transmission  calculation;  selection  of  MODTRAN  molecular  radiators 
not  supported  by  SHARC-3  is  made  from  the  MODTRAN  PARAMETERS  sub-menu  (Section 
4.3.7). 
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4)  REVIEW  OR  MODIFY  SPECTRAL  INPUTS... 

CURRENT  VALUES  ARE: 

1500 
4000 
1 

AFGL  ISOTOPE#  1 
AFGL  ISOTOPE#  1 
1 

ENTER  #  OF  ITEM  TO  BE  CHANGED  OR 
0  TO  CONTINUE 


1.  MINIMUM  WAVENUMBER  : 

2.  MAXIMUM  WAVENUMBER : 

3.  SPECTRAL  RESOLUTION  (MINIMUM  OF  1  CM-1)  : 

4.  SPECIES  INCLUDED  IN  RADIANCE  CALCULATION 

NO  ISOTOPE  14N160 

NO+  ISOTOPE  14N  160  + 

5.  SPECTRAL  STEP  SIZE  FOR  OUTPUT 


Figure  3.  SPECTRAL  INTERVAL,  RESOLUTION,  AND  SPECIES  Sub-Menu. 
4.2.5  OUTPUT  DATA 


SAMM  has  eliminated  the  line-of-sight  (Entry  9)  and  spectral  radiance  (Entry  10) 
output  options  from  the  SHARC-3  OUTPUT  DATA  sub-menu.  SAMM  performs  the  LOS 
and  radiative  transport  calculations  in  the  MODTRAN  section  of  the  code,  and  uses 
MODTRAN  inputs  (Sections  4.3.2  and  4.3.3)  to  determine  which  LOS  and  spectral  data  are  to 
be  printed. 

4.2.6  STANDARD  SET-UP  FOR  FILE  NAMES 

The  STANDARD  SET-UP  FOR  FILE  NAMES  sub-menu  in  SAMM  differs  from  the 
corresponding  sub-menu  in  SHARC-3  in  that  it  allows  the  user  to  determine  which  output  files 
are  to  be  saved,  and  which  are  to  be  deleted  at  the  completion  of  a  run.  Figure  4  contains  a 
sample  of  this  sub-menu.  After  entering  1  from  this  menu,  the  user  is  prompt  for  a  new  root 
name  for  the  output  files.  The  keep/delete  status  of  an  output  file  is  toggled  by  entering  the 
letter  at  the  beginning  of  the  line  containing  the  output  file  name  (A-J).  Since  SAMM  output 
can  be  large,  disk  space  can  be  saved  by  deleting  unneeded  output.  This  is  especially 
convenient  if  numerous  SAMM  runs  are  being  performed  sequentially. 
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6)  REVIEW  OR  MODIFY  STANDARD  I/O  FILE  NAMES 

AND 

THEIR  STATUS 

1  A. 

KEEP 

SPECTRAL  RADIANCE  FILE 

TESTl.SPC 

B. 

KEEP 

TRANSMISSION  FILE 

TESTl.TRN 

C. 

KEEP 

STANDARD  OUTPUT  FILE 

TESTl.OLT 

D. 

KEEP 

STANDARD  INPUT  FILE 

TESTl.INP 

E. 

KEEP 

BANDPASS  HLE 

TESTl.RAD 

F. 

KEEP 

MODTRAN  INPUT  FILE 

TEST1.TP5 

G. 

KEEP 

MODTRAN  STANDARD  OUTPUT  FILE 

TEST1.TP6 

H. 

KEEP 

MODTRAN  PLOTTING  FILE 

TEST1.TP7 

1. 

KEEP 

MODTRAN  AUXILIARY  OUTPUT  FILE 

TEST1.TP8 

J. 

DELETE 

MOSART  INPUT  FILE 

TESTl.INM 

2. 

CASE  SELECTION  FOR  FILE  NAMES 

UPPER 

3. 

DIRECTORY  PATH  FOR  OUTPUT  FILES 

OUTDIR/ 

ENTER 

# 

OF  ITEM  TO  BE  CHANGED  OR 

LETTER 

TO  TOGGLE  FILE  STATUS  OR 

0 

TO  CONTINUE 

Figure  4.  STANDARD  SET-UP  FOR  FILE  NAMES  Sub-Menu. 


4.2.7  INSTALLATION  SETUP 


The  INSTALLATION  SETUP  sub-menus  from  SAMM  and  SHARC  are  essentially 
identical.  The  only  caveat  is  that  the  directory  name  selected  for  the  SHARC  lines  files  is  also 
the  directory  name  for  the  band  model  parameter  file.  Thus,  these  two  data  files  must  be  in 
the  same  directory.  Also,  SAMM  permits  the  user  to  input  the  name  of  the  unformatted, 
direct-access  band  model  parameter  tape  (the  default  name  is  UFTAPE). 


4.2.8  EXIT/CONTINUE  OPTIONS 


The  SAMM  exit/continue  options.  Entries  8,  9,  10  &  999  from  the  top-level  menu, 
have  the  same  meaning  as  in  SHARC-3.  However,  if  Entry  8,  9,  or  999  is  selected  and  a 
repeat  run  is  requested  (see  MODTRAN  PARAMETERS),  the  interactive  module  will  not 
terminate  until  prompting  for  repeat  run  inputs  is  completed. 


-20- 


4.3  The  Interactive  Input  Module  -  MODTRAN  PARAMETERS 


Selecting  Entry  11  from  the  top-level  menu,  Figure  1,  displays  the  MODTRAN 
PARAMETERS  sub-menu,  Figure  5.  The  inputs  are  primarily  those  from  CARDl  and 
CARDS  of  MODTRAN. 

4.3.1  RUNMOD 

The  character*!  string  "RUNMOD"  replaces  the  logical  variable  "MODTRN”  from  the 
MODTRAN  program.  RUNMOD  is  used  to  select  the  mode  in  which  SAMM  is  to  be  run. 
The  current  choices  are: 

"S"  SAMM  mode,  combined  LBL/band  model  calculations; 

"M"  MODTRAN  mode,  an  LTE  band  model  calculation;  or 
"G"  GEOMETRY  mode,  a  calculation  of  column  densities  only. 


1 1)  MODTRAN  VARIABLES  THE  USER  CAN  MODIFY  AND 

THEIR  CURRENT 

VALUES  ARE: 

1) 

RUNMOD 

z:^ 

S 

SAMM  COMBINED  LBL/BAND  MODEL  CALCUTATION 

2) 

lEMSCT 

= 

2 

THERMAL -hSOLAR  RADIANCE  CALCULATION 

IPH 

= 

0 

HENYEY-GREENSTEIN  AEROSOL  PHASE  FUNCTION 

G 

= 

0.900000 

HENYEY-GREENSTEIN  ASYMMETRY  FACTOR 

IMULT 

= 

1 

MULTIPLE  SCATTERING  TO  BE  CALCULATED 

3) 

NOPRT 

= 

0 

NORMAL  OUTPUT  PRINTED 

4) 

TBOUND 

= 

0.000  K 

(NO  SOURCE  AT  END  OF  LOS) 

5) 

SALB 

= 

0.000000 

GROUND  SCATTERING  ALBEDO 

6) 

IRPT 

= 

0 

THIS  WILL  BE  THE  FINAL  CALCULATION 

7) 

LMOL 

= 

N20 

EXCLUDED  02  EXCLUDED 

S02 

EXCLUDED  N02  EXCLUDED 

NH3 

EXCLUDED  HN03  EXCLUDED 

ENTER  §  TO  MODIFY 

0  TO  CONTINUE 

Figure  5.  MODTRAN  PARAMETERS  Sub-Menu. 
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4.3.2  lEMSCT,  IPH,  G,  and  IMULT 


Entry  2  from  the  MODTRAN  PARAMETERS  sub-menu  determines  the  type  of 
radiance/transmittance  calculation  to  be  performed.  Following  MODTRAN,  the  fotir  options 
controlled  by  lEMSCT  are: 

"T"  Transmittance  only  (lEMSCT =0), 

"R"  Thermal  Radiance  (IEMSCT=1), 

"S"  Solar  +  Thermal  Radiance  (lEMSCT =2),  and 
"I"  Transmitted  Solar  Irradiance  (lEMSCT =3). 

Although  the  radiance  calculations  do  output  total  transmittance,  the  layer  loop  for  each 
frequency  is  terminated  once  the  total  transmittance  drops  below  10  the  transmittance  option 
loops  over  all  layers  allowing  the  user  to  calculate  smaller  total  transmittances  and  to  separate 
out  the  contributions  to  transmittance  from  each  of  the  extinction  sources.  When  radiance 
calculations  are  performed,  multiple  scattering  can  be  included.  If  single  or  multiple  scattering 
is  turned  on,  either  a  Henyey-Greenstein,  a  user-defined,  or  a  pre-stored  MIE  phase  function 
may  be  selected.  An  asymmetry  factor  is  input  for  use  with  the  Henyey-Greenstein  function, 
and  a  PHASE.INP  file  must  be  supplied  if  a  user-defined  phase  function  is  requested.  It  is 
advised  that  users  avoid  the  pre-stored  MIE  phase  functions  for  band  radiance  profile  studies 
that  pass  through  30  km  altimde;  these  phase  functions  can  introduce  a  false  discontinuity. 
The  LOWTRAN  7  manual^^^  provides  additional  details  about  the  phase  function  inputs. 

4.3.3  NOPRT 

The  NOPRT  input  determines  the  amount  of  output  generated  in  the  MODTRAN 
standard  output  file,  rootname.TP6.  It  is  recommended  that  this  input  generally  be  set  to  1 
(enter  "S"  in  the  interactive  mode)  so  that  the  Small  (minimal)  output  is  generated.  Minimal 
output  includes  a  listing  of  the  MODTRAN  inputs,  optical  path  column  densities  for  all 
extinction  sources,  and  spectral  &  bandpass  radiance/transmittance  data.  Entering  M  sets 
NOPRT  to  0,  and  the  Medium  (so-called  normal)  output  is  produced,  which  includes  all 
MODTRAN  molecular  and  aerosol  profiles  (0-100  km)  and  column  densities  for  the  scattering 
point  to  sun  paths.  A  value  of  -1  is  assigned  to  NOPRT  when  "L"  for  Large  is  entered,  and 
then  optical  and  sun  path  column  densities  for  each  vibrationally  excited  state  of  the  included 
SHARC  radiators  is  output. 
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When  NOPRT  equals  -1,  additional  data  is  also  output  to  the  MODTRAN  auxiliary 
file,  rootname.TPS.  For  a  transmission  run  (IEMSCT=0),  the  contribution  to  spectral 
transmission  from  each  species  is  printed  out;  for  multiple  scattering  runs  (IMULT=1), 
weighting  function  data,  i.e.,  the  change  in  total  transmittance  with  segment  length  along  the 
LOS,  is  output. 

4.3.4  TBOUND 

When  the  MODTRAN  variable  TBOUND  is  non-zero,  a  blackbody  source  is  placed  at 
the  end  of  the  input  LOS.  If  TBOUND  exceeds  zero,  its  value  is  taken  to  be  the  blackbody 
temperature  in  Kelvin  (the  emissivity  is  determined  from  SALB,  Section  4.3.5).  When 
TBOUND  is  less  than  or  equal  to  zero,  a  blackbody  source  is  placed  at  the  end  of  the  LOS 
only  if  the  PATH  terminates  at  the  earth’s  surface;  in  that  case,  the  atmospheric  profile 
temperature  at  0  km  altitude  is  assumed  to  be  the  surface  temperature  (note  that  TBOUND  is 
never  used  as  the  earth’s  surface  temperature  for  multiple  scattering  calculations). 

4.3.5  SALB 

SALB  is  a  wavelength  independent  scattering  albedo,  and  its  allowed  values  range  from 
zero  and  one,  inclusive.  When  TBOUND  exceeds  zero,  1-SALB  is  the  source  emissivity. 
SALB  is  also  the  ground  scattering  albedo  used  in  the  multiple  scattering  calculations  and  used 
to  determine  the  surface  blackbody  and  reflected  solar  contributions  for  LOS  terminating  at  the 
earth’s  surface. 

4.3.6  IRPT 

The  IRPT  option  enables  a  user  to  perform  multiple  calculations  in  a  fixed  environment 
without  having  to  rerun  SAMM  for  each  calculation.  This  option  has  many  applications  such 
as  comparing  MODTRAN  and  SAMM  results  for  an  identical  LOS  (TEST  CASE  6),  or 
determining  bandpass  radiance  profiles  (TEST  CASE  7).  Repeat  runs  are  not  permitted 
following  a  geometry  only  run  (RUNMOD  =  ’G’). 

If  IRPT  equals  zero,  a  single  LOS  calculation  is  performed.  IRPT  must  be  set  to  1  or 
4  to  run  an  additional  calculation.  No  new  column  densities  are  calculated  when  IRPT=4. 
This  "old  column  densities"  option  can  be  used 
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•  to  switch  from  a  combined  LBL/band  model  calculation. 
RUNMOD="S",  to  a  straight  band  model  calculation,  RlJNMOD="M", 
or  vice  versa, 

•  to  change  spectral  bandpass  parameters,  or 

•  to  follow  a  radiance  calculation,  IEMSCT=1  or  IEMSCT=2,  by  a 
transmittance  calculation,  IEMSCT=0,  (the  reverse  order  is  not  permitted 
since  the  transmission  calculation  does  not  generate  all  the  column 
densities  required  for  a  radiance  run). 

When  IRPT  equals  1,  a  repeat  run  calculation  is  performed  in  which  all  new  column 
densities  are  generated.  Any  new  LOS  can  be  run.  The  primary  restrictions  are  that  the 
ambient  and  auroral  environments  remain  fixed,  the  sun  location  is  held  constant,  and  no 
changes  are  made  in  the  radiator  list  (this  last  requirement  will  be  dropped  in  future  versions  of 
SAMM). 

Determining  when  IRPT  should  be  set  to  1  and  when  it  can  be  set  to  4  might  seem 
confusing.  In  fact,  the  interactive  model  automatically  determines  whether  new  column 
densities  need  to  be  calculated  by  examining  the  LOS  inputs,  and  assigns  the  proper  value  to 
IRPT.  It  is  only  important  for  the  user  to  understand  the  difference  if  he  or  she  is  modifying 
the  SAMM  input  stream  by  directly  editing  the  SAMM.INP  file.  In  that  case,  it  is  critical  that 
the  user  specifies  the  correct  value. 

When  a  repeat  run  is  requested  and  the  user  types  Entry  8,  9,  or  999  from  the  top-level 
menu.  Figure  1,  the  interactive  module  does  not  terminate.  Instead  the  new  menu  shown  in 
Figure  6,  appears,  prompting  the  user  for  the  first  repeat  run  inputs.  If  the  original 


REVIEW  OR  MODIFY  INPUT  DATA  FOR  REPEAT  RUN  #  1 

1)  EXIT  WITH  REPEAT  RUN  #  1  ELIMINATED 

2)  MODTRAN  PARAMETERS 

3)  LOS  GEOMETRY 

4)  SPECTRAL  INTERVAL  AND  RESOLUTION 

ENTER  it  OF  ITEM  TO  BE  CHANGED  OR 

5  TO  CONTINUE  (REPEAT  RUN  INPUT  COMPLETED) 


Figure  6.  REPEAT  RUN  #  1  Menu. 
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SAMM.INP  file  included  inputs  for  a  repeat  run,  those  inputs  are  the  assumed  defaults.  On 
the  other  hand,  if  the  specification  of  a  repeat  run  is  new,  the  default  parameters  for  the  repeat 
run  are  those  from  the  prior  calculation. 

The  REPEAT  RUN  sub-menus  are  identical  to  the  corresponding  top-level  sub-menus 
except  for  necessary  omissions.  Since  repeat  runs  must  include  the  same  radiator  lists.  Entry  7 
from  the  MODTRAN  PARAMETERS  sub-menu.  Figure  5,  and  Entry  4  from  the  SPECTRAL 
INTERVAL  sub-menu.  Figure  3,  have  been  deleted.  The  LOS  GEOMETRY  sub-menu  differs 
in  that  the  SUN  LOCATION  option.  Entry  2  from  Figure  2,  is  removed. 

In  the  MODTRAN  PARAMETERS  sub-menu,  the  IRPT  variable  always  refers  to  the 
next  repeat  run.  Thus,  if  IRPT  is  not  set  to  0  and  the  user  responds  5  from  the  REPEAT  RUN 
#  1  menu.  Figure  6,  a  REPEAT  RUN  #  2  menu  will  appear.  To  terminate  the  interactive 
session  after  a  single  repeat  run,  either  set  IRPT  to  0  in  the  MODTRAN  PARAMETERS 
sub-menu,  or  let  the  REPEAT  RUN  #  2  menu  appear  and  then  enter  a  1.  This  entry 
eliminates  the  current  repeat  run.  If  1  were  to  be  entered  directly  from  REPEAT  RUN  #  1 
menu,  no  repeat  run  would  be  performed. 

SAMM  presently  allows  "approximately"  50  repeat  runs  (the  acmal  number  of  allowed 
repeat  runs  depends  on  the  number  of  lines  of  input  in  the  first  calculation,  and  this  varies 
depending  on  the  number  of  radiators,  the  number  of  regions,  etc.).  If  more  runs  are 
requested,  an  error  will  appear  in  the  roomame.LOG  file  to  indicate  that  parameter 
"NDMAXM"  must  be  increased  in  file  PARMS.H.  This  parameter  should  be  increased  by  5 
for  each  additional  run  requested. 

4.3.7  LMOL 

The  array  LMOL  is  used  to  determine  which  of  the  six  band  model  radiators  (N2O,  O2, 
SO2,  NO2,  NH3  &  HNO3)  are  to  be  included  in  a  LOS  radiance/transmittance  calculation. 
Any  combination  of  the  radiators  may  be  included  in  a  calculation.  However,  even  if  a 
molecule  is  excluded  from  a  radiance  calculation,  its  attenuation  of  solar  irradiance  from  below 
30  km  is  still  included  in  the  calculation  of  solar  attenuation  rates.  This  is  true  even  though 
this  attenuation  is  not  modeled  when  calculating  single  and  multiple  scatter  solar  radiance 
contributions. 
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5.  SAMM  OUTPUT  FILES 


Entry  6  of  the  top-level  menu.  Figure  1,  prompts  the  user  for  an  output  root  name. 
This  root  name  is  used  along  with  appropriate  suffixes  to  name  all  SAMM  output  files  except 
the  journal  file  and  population  files. 

5.1  Journal  File 

The  SAMM  journal  file  (SAMM.LOG)  contains  various  informational  statements 
generated  during  SAMM  execution  of  the  SHARC-3  routines.  The  majority  of  messages  are 
due  to  improper  preparation  of  the  input  files.  An  "error"  message  during  execution  is 
considered  fatal,  and  execution  will  stop  after  the  error  message  is  written  to  the  journal  file. 
A  "warning"  or  "caution"  message  is  not  fatal  (that  is,  does  not  terminate  execution),  but  it 
should  inform  the  user  that  input  files  are  inconsistent,  that  only  a  partial  calculation  has  been 
performed,  or  that  numerical  difficulties  have  been  encountered  and  fixed  in  one  of  the 
SHARC-3  modules.  The  user  should  monitor  the  journal  file  after  each  SAMM  run  to  insure 
that  the  desired  calculation  was  properly  performed.  The  journal  file  is  deleted  just  prior  to 
code  completion  if  no  messages  were  written  to  the  file. 

During  auroral  calculations,  several  warning  messages  are  routinely  given  stating  that 
different  molecular  species  were  not  found.  Since  auroral  excitation  is  only  calculated  for 
CO2,  NO,  and  NO-I-,  these  messages  are  reasonable,  but  the  user  should  check  that  these 
species  were  not  inadvertently  omitted  too. 

5.2  SAMM  Input  File 

When  SAMM  is  run,  a  copy  of  the  input  file  (SAMM.INP)  is  written  to  the  output 
directory  as  rootname.INP.  This  helps  avoid  the  possibility  of  losing  the  original  input.  If 
SAMM.INP  contains  extraneous  information  at  the  end  of  the  file,  that  information  will  be 
lost.  Also,  if  the  user  happens  to  choose  "SAMM"  for  the  root  name,  the  copy  of 
SAMM.INP  is  written  to  SAM.INP  to  avoid  writing  over  the  original  input  file. 

The  rootname.INP  file  can  be  used  as  a  SHARC-3  input  file  by  copying  the  file  into 
SHARC.INP  and  appending  the  lines  containing  the  population  file  solar  zenith  angles  with  the 
appropriate  lower  atmosphere  aerosol  number.  SHARC-3  will  ignore  the  MOSART  and 
MODTRAN  input  parameters  which  are  located  at  the  end  of  the  rootname.INP  file.  For 
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SHARC,  the  LOS  must  not  drop  below  50  km.  Also,  the  atmospheric  profile,  the  population 
and  the  binary  lines  files  for  SHARC-3  and  SAMM  are  different;  an  error  will  be  logged  if 
SAMM  profile,  population  or  line  files  are  used  as  input  to  SHARC-3. 

5.3  SHARC  General  Output  File 

The  SHARC  general  output  file  "rootname.OUT"  contains  a  summary  of  selected 
output  from  each  of  the  SHARC-3  modules  in  SAMM.  The  format  of  this  file  is  identical  to 
that  of  SHARC-3.  The  SAMM  version  is  different,  however,  in  that  no  column  density  or 
radiance  information  is  included;  the  SHARC-3  column  density  and  radiance  modules  are  not 
part  of  SAMM.  A  description  of  the  SHARC-3  general  output  file  is  included  in  Section  5.2 
of  the  SHARC-3  manual.(^> 

5.4  Population  File 

For  a  given  set  of  radiators  and  kinetic  schemes,  the  excited-state  populations  for  each 
atmospheric  layer  will  change  only  when  a  new  model  atmosphere  is  used,  a  new  solar  zenith 
angle  is  defined,  or  auroral  conditions  change.  Thus,  the  excited-state  populations  and  the 
information  necessary  to  uniquely  characterize  them  are  written  to  a  binary  "population"  file. 
This  allows  the  user  to  perform  multiple  SAMM  calculations  without  re-calculating  the 
populations  each  time.  Since  these  calculations  are  usually  the  most  cpu  intensive  part  of  a 
SAMM  run,  using  previously  saved  population  files  can  be  a  great  benefit.  The  information 
saved  in  a  population  file  is: 

•  The  model  atmosphere  file  name, 

•  The  molecular  radiators  and  the  associated  "linking",  "states",  and 
"bands"  file  names, 

•  The  list  of  species  for  each  molecular  radiator, 

•  The  molecular  states  file  for  each  molecular  radiator, 

•  The  state  populations  and  associated  temperatures  for  each  radiator,  and 

•  The  auroral  parameters  when  the  auroral  option  is  used. 

The  populations  directory  and  population  file  names  are  defined  by  the  user  in  the 
interactive  input  session  from  sub-menus  7  and  2  of  the  top-level  menu,  respectively.  If  not 
suppressed,  the  population  file  names  will  be  appended  with  the  root  of  the  atmospheric  profile 
name  and  with  the  solar  zenith  angle  written  as  a  three  digit  integer  (000  to  180).  Thus,  if  the 
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"MIDLAT.DAY"  atmosphere  is  used  with  a  45°  solar  zenith  angle  and  the  input  root 
population  name  is  "P",  the  output  population  file  will  have  the  name  "PMIDLAT.045". 

5.5  Spectral  Radiance  File 

The  ASCII  file  "rootname.SPC"  is  a  simple  two  column  file.  The  frequency  (cm‘^) 
and  the  spectral  radiance  (W/sr/cm'/cm'^)  are  written  as  an  (x,y)  ordered  pair.  This  format  is 
convenient  for  either  plotting  the  calculated  spectral  radiance  directly  or  reducing  these  data 
further.  For  example,  the  user  may  wish  to  apply  a  specific  filter  function  to  the  spectral 
radiance  or  to  convert  to  a  set  of  units  other  than  those  used  in  SAMM  (these  manipulations 
can  be  performed  using  DEGRAD. f,  a  FORTRAN  program  included  on  the  SAMM  tape). 
The  data  is  printed  at  a  constant  frequency  interval  equal  to  the  step  size  defined  in  the  spectral 
bandpass  data  sub-menu,  Section  4.2.4.  A  "$"  delimiter  in  column  2  is  used  to  separate  data 
generated  from  repeat  runs,  Section  4.3.6;  the  delimiter  lines  also  list  the  bandpass  radiance 
and  the  frequency  and  value  of  the  spectral  radiance  maximum.  For  transmission  only  runs 
(lEMSCT  =  0  or  3),  no  data  is  output  to  rootname.SPC,  even  though  the  file  is  created. 

5.6  Spectral  Transmittance  File 

The  ASCII  file  "roomame.TRN"  contains  the  calculated  spectral  transmittance.  As 
with  the  spectral  radiance  file,  this  plot  file  contains  two  columns  with  the  frequency  (cm'^) 
and  transmittance  written  as  an  (x,y)  ordered  pair  (conversion  to  wavelengths  or  application  of 
a  filter  function  can  be  performed  using  the  DEGRAD. f  program).  The  data  is  printed  at  a 
constant  frequency  interval,  the  step  size  defined  in  the  spectral  data  sub-menu.  Section  4.2.4. 
A  "$"  delimiter  in  column  2  is  used  to  separate  data  generated  from  repeat  runs.  Section  4.3.6. 
For  radiance  calculations  (lEMSCT  =  1  or  2),  the  total  transmittance  is  output  with  only  five 
decimal  places  since  the  loop  over  LOS  segments  at  any  given  frequency  is  terminated  once 
total  transmittance  drops  below  10  For  transmittance  calculations,  results  are  ouiput  with 
ten  decimal  places;  these  values  generally  contain  three  or  four  significant  digits. 

5.7  Bandpass  Radiance  File 

The  ASCII  file  "rootname.RAD"  contains  in-band  (top  hat)  radiances  for  the  spectral 
interval  of  the  calculation.  Values  from  multiple  calculations  can  be  used  to  plot  bandpass 
radiance  profiles.  Each  line  contains  three  numbers  followed  by  a  descriptive  character  string. 
The  numbers  in  order  are  the  bandpass  radiance  (W/cm^-sr),  the  minimum  LOS  altimde  (km) 
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and  the  observer  altimde  (km).  For  a  series  of  limb,  half-limb  or  zenith  calculations,  the 
minimum  LOS  altitude  is  the  pertinent  ordinate  (y  coordinate)  for  plotting;  for  a  series  of  nadir 
calculations,  the  observer  altitude  is  the  key  ordinate.  If  no  repeat  SAMM  runs  are  performed, 
rootname.RAD  contains  only  a  single  line  of  data.  For  transmission  only  runs  (lEMSCT  =  0 
or  3),  no  data  is  written  to  rootname.RAD,  even  though  the  file  is  created. 

5.8  MODTRAN  Input  File 

SAMM  creates  a  MODTIL-\N  standard  input  stream,  "rootname.TPS".  This  file  can 
generally  be  used  to  run  the  standard  MODTRAN  externally  firom  SAMM.  The  results  should 
be  similar  but  not  necessarily  identical  to  those  obtained  by  running  MODTRAN  within 
SAMM,  RUNMOD  =  "M"  (Section  4.3.1).  MODTRAN  within  SAMM  has  an  upgraded 
colunrn  density  calculation  (Appendix  H),  uses  different  layering,  and  allows  the  possibility  of 
multiple  regions  and/or  multiple  profiles  above  30  km. 

The  "rootname.TPS"  file  differs  from  the  MODTRAN  "TAPES"  file  in  a  few  respects. 
The  character  in  colunrn  1  of  CARD  1  is  no  longer  a  logical  variable,  T  for  MODTRAN  and  F 
for  LOWTRAN.  Instead,  it  is  the  character  variable  "RUNMOD"  described  in  Section  4.3.1. 
Also,  colunrn  11  of  CARD  1  contains  a  letter  indicating  the  specific  geometry  inputs;  the 
letters  correspond  to  the  letters  on  page  36  of  the  LOWTRAN  7  manual, (a  &  b  for 
horizontal  paths;  a,  b,  c  &  d  for  slant  paths;  and  a  &  b  for  paths  to  space).  CARD  3  has 
additional  geometry  input  in  columns  66  through  120.  Column  70  contains  the  character  string 
"DIR",  equal  to  "T"  or  "B"  depending  on  whether  "LONG2"  and  "LAT2"  are  "T”oward  or 
"B"ehind  the  LOS  from  the  observer.  The  longimde  (degrees  West  of  Greenwich)  and  latitude 
(degrees  North  of  the  Equator)  of  the  observer  are  specified  in  columns  71  through  90, 
formatted  2F10.3.  The  next  20  columns,  also  formatted  2F10.3,  contain  "LONG2"  and 
"LAT2",  the  longimde  and  latimde  of  an  auxiliary  point  used  to  specify  path  azimuth.  If  the 
path  azimuth  is  directly  specified,  its  value  in  degrees  East  of  North  is  written  in  columns  111 
through  120,  formatted  F10.3. 

To  convert  "rootname.TPS"  into  a  MODTRAN  "TAPES"  file  for  direct  use  by 
MODTRAN,  two  changes  are  necessary  on  the  first  line  of  the  file  (CARD  1).  The  character 
in  column  1  must  be  replaced  with  "T",  and  the  character  in  column  11  replaced  with  a 
blank,  "  ".  If  repeat  runs  are  requested,  these  same  changes  must  be  made  to  the  additional 
CARD  I’s.  The  TAPES  file  can  not  be  converted  directly  to  a  valid  MODTRAN  input  for 
limb  calculations  (ITYPE  in  column  10  of  CARD  1  equal  to  4)  or  for  slant  paths  defined  by 
specifying  the  latimde  and  longimde  of  the  source  point  ("2E"  in  columns  10-11  of  CARD  1). 
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5.9  MODTRAN  Standard  Output  File 


The  SAMM  output  file  "rootname.TP6"  is  similar  to  the  MODTRAN  "TAPE6"  output 
file.  The  input  parameter  NOPRT  determines  the  amount  of  information  written  to  the  file,  as 
described  in  Section  4.3.3.  The  major  difference  between  the  SAMM  and  MODTRAN 
versions  is  that  the  SAMM  file  tracks  the  latitude  and  longimde  along  the  LOS.  Also,  the 
SAMM  file  enables  the  user  to  output  vibrational  state  column  densities.  "rootname.TP6"  and 
"TAPE6"  use  the  same  format  for  the  tables  of  radiances  and/or  transmittances  vs  frequency. 
The  column  66  through  120  CARD  3  input  described  in  the  previous  section  is  also  included  as 
output  in  the  "rootname.TP6"  file. 

5.10  MODTRAN  Plotting  File 

The  file  "rootname.TP?"  is  SAMM’s  version  of  MODTRAN’s  "TAPE?"  file.  The 
"rootname.TP?"  file  can  be  used  as  input  to  MODTRAN’s  plotting  package.  One  change  has 
been  made  to  this  file  for  radiance  calculations  (lEMSCT  =  1  or  2).  In  this  case  four  columns 
have  been  added  to  the  frequency  dependent  output.  They  contain  the  layer  number  at  which 
the  radiance  calculation  was  terminated  (i.e.,  the  layer  at  which  transmission  dropped  below 
10'^)  and  the  corresponding  terminating  altitude  (km),  latitude  (degrees  North  of  the  Equator), 
and  longitude  (degrees  West  of  Greenwich). 

5.11  MODTRAN  Auxiliary  Output  File 

The  file  "rootname.TPS"  is  SAMM’s  version  of  MODTRAN’s  "TAPES"  file.  One 
change  has  been  made  to  this  file.  For  transmission  only  calculations  (lEMSCT  =  0),  the 
transmission  for  HNO3,  OH  and  NO"^  has  been  added  to  the  output. 
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6.  SAMM  DATA  FILES 


In  general,  the  SAMM  data  files  have  the  same  format  as  the  corresponding  SHARC-3 
data  files.  Information  on  the  content  and  structure  of  all  these  files  is  presented  in  Section  6 
of  the  SHARC-3  manual. As  noted  above  (Subsection  3.2),  the  Curtis-Godson  files  for  solar 
irradiance  are  not  used  by  SAMM;  solar  attenuation  by  the  lower  atmosphere  is  directly 
calculated  using  the  MODTRAN  module. 

The  SAMM  atmospheric  profiles  differ  from  those  of  SHARC-3  in  that  the  former 
begin  at  0  km  (ground  level)  whereas  the  latter  begin  at  50  km.  Also,  the  SAMM  profiles 
contain  5  additional  species:  N2O,  SO2,  NO2,  NH3  &  HNO3.  SAG,  the  SHARC/SAMM 
Atmosphere  Generator,  can  still  be  used  to  generate  the  desired  atmospheric  profiles;  the  SAG 
interactive  module  prompts  the  user  to  determine  whether  SHARC  or  SAMM  profiles  are  to  be 
generated.  For  SAMM,  standard  atmospheric  profiles  are  layered  in  1  km  increments  from  0 
to  25  km,  in  2  km  increments  from  30  to  150  km,  and  in  10  km  increments  from  160  to  300 
km  for  a  total  of  102  layer  boundaries.  Different  layer  structuring  can  be  input,  but  SAMM 
currently  restricts  the  number  of  layers  below  30  km  to  26. 


7.  AUXILIARY  PROGRAMS 


The  SAMM  module  is  delivered  with  two  auxiliary  programs.  They  are  sag.f,  the 
SH ARC/S AMM  Atmospheric  Generator,  and  DEGRAD. f,  a  filter  function  routine. 

7.1  The  SAG  Program 

The  SAG  program  generates  atmospheric  profiles  given  temporal,  geographic  location, 
and  solar  activity  inputs,  basing  predictions  on  existing  knowledge  of  the  chemical  constituent 
variabilities.  Extensive  use  is  made  of  the  MSISE-90^^^^  and  the  NRL  climatology^ models. 
SHARC,  MODTRAN  and  SAMM  atmospheric  profile  data  files  are  standard  outputs  of  the 
SAG  module.  User  instructions  for  the  code  are  included  in  Section  7.3  of  the  SHARC-3 
manual^^^  and  in  the  SAG  manual. The  SAG  manual  also  contains  a  discussion  of  the 
required  assumptions  and  data  sources  used  in  developing  the  SAG  module. 

7.2  The  DEGRAD  Program 

The  DEGRAD  program  is  used  to  degrade  the  spectral  resolution  of  SAMM  spectral 
radiance  and  transmittance  data.  DEGRAD  is  an  internal  SSI  code  delivered  as  a  courtesy. 
DEGRAD  accepts  as  input  the  SAMM  spectral  radiance  and  spectral  transmittance  files,  and 
enables  the  user  to  pass  any  of  a  variety  of  filter  functions  over  the  data.  The  program 
interactively  prompts  the  user  for  all  required  inputs  using  a  menu  driven  system.  Default 
inputs  are  stored  in  a  DEGRAD. INP  file;  if  no  such  file  exists,  one  is  created  when  the 
program  is  executed. 
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APPENDIX  A 

IMPLEMENTATION  INSTRUCTIONS 


APPENDIX  A 


IMPLEMENTATION  INSTRUCTIONS 


SAMM,  SHARC  And  MODTRAN  Merged,  is  delivered  with  the  FORTRAN  source 
code,  input  data  sets,  and  seven  test  cases.  The  SAMM  package  contains  232  files.  The  files 
are: 


SAMM  EXECUTABLE  DIRECTORY 


1 

Samdrv.f 

Main  program 

FORTRAN 

1715  lines 

2 

ambien.f 

Ambient  environment 

FORTRAN 

2963  lines 

3 

aurora,  f 

Auroral  environment 

FORTRAN 

591  lines 

4 

chmkin.f 

CHEMKIN  subroutines 

FORTRAN 

4043  lines 

5 

geolos.f 

SHARC-3  LOS  geometry  subroutines 

FORTRAN 

4740  lines 

6 

geoseg.f 

SHARC-3  Segment  geometry  subroutines 

FORTRAN 

946  lines 

7 

inactv.f 

Interactive  subroutines 

FORTRAN 

6538  lines 

8 

input,  f 

SHARC-3  Input  subroutines 

FORTRAN 

3393  lines 

9 

inutil,  f 

Input  utilities  subroutines 

FORTRAN 

2778  lines 

10 

modaer.f 

MODTRAN  aerosol  subroutines 

FORTRAN 

1681  lines 

11 

modblk.f 

Block  data  subroutines 

FORTRAN 

4417  lines 

12 

moddrv.f 

MODTRAN  driver  subroutine 

FORTRAN 

1725  lines 

13 

modgeo.f 

MODTRAN  geometry  subroutines 

FORTRAN 

2089  lines 

14 

modlay.f 

MODTRAN  layer  loop  subroutines 

FORTRAN 

3723  lines 

15 

modrad.f 

Radiance  subroutines 

FORTRAN 

4835  lines 

16 

modssg.f 

MODTRAN  solar  scatter  path  subroutines 

FORTRAN 

458  lines 

17 

mosinp.f 

MOSART  input  subroutines 

FORTRAN 

3788  lines 

18 

output,  f 

SHARC-3  Output  subroutines 

FORTRAN 

1379  lines 

19 

saminp.f 

SAMM  input  subroutines 

FORTRAN 

2776  lines 

20 

samseg.f 

SAMM  column  density  subroutines 

FORTRAN 

2091  lines 

21 

AMBIEN.H 

Ambient  NLTE  calculations  common 

FORTRAN 

22  lines 

22 

BMCOM.H 

Band  model  data  common 

FORTRAN 

7  lines 

23 

CARDl.H 

MODTRAN  card  1  common 

FORTRAN 

3  lines 

24 

CARD2.H 

MODTRAN  card  2  common 

FORTRAN 

2  lines 

25 

CARD2D.H 

MODTRAN  card  2D  common 

FORTRAN 

2  lines 

26 

CARD3.H 

MODTRAN  card  3  common 

FORTRAN 

2  lines 

27 

CG.H 

Curtis-Godson  sums  common 

FORTRAN 

4  lines 

28 

CNSTNS.H 

Constants  common 

FORTRAN 

3  lines 

29 

CNTRL.H 

MODTRAN  column  densities  common 

FORTRAN 

5  lines 

30 

DIRPKA.H 

Directory  &  file  names  common 

FORTRAN 

27  lines 
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31 

FILES.H 

File  unit  number  parameters 

FORTRAN 

35  lines 

32 

HIALT.H 

SAMM  geometry  array  common 

FORTRAN 

12  lines 

33 

IFIL.H 

MODTRAN  file  unit  numbers  common 

FORTRAN 

1  lines 

34 

INPDAT.H 

MOSART  input  strings  common 

FORTRAN 

5  lines 

35 

ISOTP.H 

Isotope  array  common 

FORTRAN 

11  lines 

36 

KNETIC.H 

Chemical  kinetic  common 

FORTRAN 

22  lines 

37 

LAY5.H 

Continuum  transmittance  common 

FORTRAN 

3  lines 

38 

LNDAT.H 

Line  data  common 

FORTRAN 

5  lines 

39 

LOSGEO.H 

SHARC-3  LOS  geometry  common 

FORTRAN 

32  lines 

40 

MODEL.H 

Model  atmosphere  common 

FORTRAN 

2  lines 

41 

MOSINP.H 

MOSART  input  variables  common 

FORTRAN 

16  lines 

42 

PARMS.H 

SHARC-3  parameters 

FORTRAN 

43  lines 

43 

PARMTR.H 

MODTRAN  geometry  data  common 

FORTRAN 

1  lines 

44 

PTH.H 

MODTRAN  path  length  common 

FORTRAN 

1  lines 

45 

RDAMAR.H 

SHARC-3  vibrational  labels  common 

FORTRAN 

8  lines 

46 

RECORD.H 

Input  records  common 

FORTRAN 

8  lines 

47 

REGGEO.H 

Region  definition  common 

FORTRAN 

26  lines 

48 

RFPTH.H 

MODTRAN  refractive  path  common 

FORTRAN 

3  lines 

49 

SM.H 

SHARC-3/MODTRAN  variable  common 

FORTRAN 

17  lines 

50 

SOLS.H 

Solar  paths  common 

FORTRAN 

2  lines 

51 

TAPE5.H 

MODTRAN  inputs  common 

FORTRAN 

25  lines 

52 

Makefile 

Sample  SAMM  make  file 

MAKE  FILE 

90  lines 

ATMOSPHERIC  PROFILES  DIRECTORY 


53 

MIDLAT.DAY 

1976  Standard  Day 

DATA 

444  lines 

54 

MIDLAT.NIG 

1976  Standard  Night 

DATA 

444  lines 

55 

T4Z091.ATM 

High  Latitude  with  90.85°  SZA 

DATA 

426  lines 

56 

T4Z093.ATM 

High  Latitude  with  93.06°  SZA 

DATA 

426  lines 

57 

T4Z095.ATM 

High  Latitude  with  95.27°  SZA 

DATA 

426  lines 

58 

T4Z097.ATM 

High  Latitude  with  97.01°  SZA 

DATA 

426  lines 

59 

T4Z099.ATM 

High  Latitude  with  98.65°  SZA 

DATA 

426  lines 

60 

T4Z101.ATM 

High  Latitude  with  100.88°  SZA 

DATA 

426  lines 

61 

T4Z102.ATM 

High  Latitude  with  101.68°  SZA 

DATA 

426  lines 

62 

T5Z091.ATM 

High  Latitude  with  91.43°  SZA 

DATA 

426  lines 

63 

T5Z094.ATM 

High  Latitude  with  94.38°  SZA 

DATA 

426  lines 

64 

T5Z097.ATM 

High  Latitude  with  96.67°  SZA 

DATA 

426  lines 

65 

T5Z099.ATM 

High  Latitude  with  99.32°  SZA 

DATA 

426  lines 

66 

T5Z102.ATM 

High  Latitude  with  101.9°  SZA 

DATA 

426  lines 

67 

T5Z104.ATM 

High  Latitude  with  104.5°  SZA 

DATA 

426  lines 

68 

T5Z108.ATM 

High  Latitude  with  107.97°  SZA 

DATA 

426  lines 
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LINE  AND  BAND  MODEL  DATA  DIRECTORY 


69 

SHARC.ASC 

ASCII  SHARC-3  line  data 

DATA 

303802  lines 

70 

UFTAPE.ASC 

ASCII  MODTRAN  band  model  data 

DATA 

67761  lines 

71 

dirac.f 

Creates  binary  line  file 

FORTRAN 

103  lines 

72 

ufmake.f 

Creates  binary  band  model  files 

FORTRAN 

134  lines 

73 

linasc.f 

Creates  ASCII  line  file 

FORTRAN 

60  lines 

74 

bmasc.f 

Creates  ASCII  band  model  files 

FORTRAN 

63  lines 

ATMOSPHERE  GENERATOR  DIRECTORY 

75 

sag.f 

SAG  source 

FORTRAN 

4257  lines 

76 

drivht.mod 

Standard  MODTRAN  altitudes  for  SAG 

DATA 

9  lines 

77 

drivht.sam 

Standard  SAMM  altitudes  for  SAG 

DATA 

24  lines 

78 

drivht.sha 

Standard  SHARC  altitudes  for  SAG 

DATA 

16  lines 

79 

sag.run 

Creates  test  case  atmospheres 

BATCH 

29  lines 

80 

sag.inp 

Input  to  makatm 

DATA 

2  lines 

81 

drT4Z091.dat 

High  latitude,  90.85°  SZA  input 

DATA 

4  lines 

82 

drT4Z093.dat 

High  latitude,  93.06°  SZA  input 

DATA 

4  lines 

83 

drT4Z095.dat 

High  latitude,  95.27°  SZA  input 

DATA 

4  lines 

84 

drT4Z097.dat 

High  latitude,  97.01°  SZA  input 

DATA 

4  lines 

85 

drT4Z099.dat 

High  latitude,  98.65°  SZA  input 

DATA 

4  lines 

86 

drT4Z101.dat 

High  latitude,  100.88°  SZA  input 

DATA 

4  lines 

87 

drT4Z102.dat 

High  latitude,  101.68°  SZA  input 

DATA 

4  lines 

88 

drT5Z091.dat 

High  latitude,  91.43°  SZA  input 

DATA 

4  lines 

89 

drT5Z094.dat 

High  latitude,  94.38°  SZA  input 

DATA 

4  lines 

90 

dfr5Z097.dat 

High  latitude,  96.67°  SZA  input 

DATA 

4  lines 

91 

drT5Z099.dat 

High  latitude,  99.32°  SZA  input 

DATA 

4  lines 

92 

drT5Z102.dat 

High  latitude,  101.9°  SZA  input 

DATA 

4  lines 

93 

drT5Z104.dat 

High  latitude,  104.5°  SZA  input 

DATA 

4  lines 

94 

drT5Z108.dat 

High  latitude,  107.97°  SZA  input 

DATA 

4  lines 

NRL  DATA  SUB-DIRECTORY 

95 

CH4.NRL 

CH4  climatology  data 

DATA 

'1443  lines 

96 

CO.NRL 

CO  climatology  data 

DATA 

1443  lines 

97 

H20.NRL 

H2O  climatology  data 

DATA 

1443  lines 

98 

HN03.NRL 

HNO3  climatology  data 

DATA 

1443  lines 

99 

N20.NRL 

N2O  climatology  data 

DATA 

1443  lines 

100 

N02.NRL 

NO2  climatology  data 

DATA 

1443  lines 

101 

03D.NRL 

O3  daytime  climatology  data 

DATA 

1443  lines 

102 

03R.NRL 

O3  night-to-day  climatology  data 

DATA 

1443  lines 

103 

OAT.NRL 

0  atom  climatology  data 

DATA 

1443  lines 

104 

TEMP.NRL 

temperature  climatology  data 

DATA 

1443  lines 
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FILTER  FUNCTION  DIRECTORY 


105  DEGRAD. f  Filter  function  source  FORTRAN  967  lines 


CHEMICAL  KINETICS  DIRECTORY 


106 

interp.f 

Chemical  kinetics  interpreter  source 

FORTRAN 

2080 

lines 

107 

interp.run 

Creates  test  case  link  files 

BATCH 

31 

lines 

108 

AC02.KIN 

CO2  auroral  kinetics  file 

DATA 

637 

lines 

109 

AC02.0UT 

CO2  auroral  interpreter  ou^ut 

DATA 

702 

lines 

no 

AC02.STA 

CO2  auroral  states/transitions  file 

DATA 

10 

lines 

111 

ANO.KIN 

NO  auroral  kinetics  file 

DATA 

667 

lines 

112 

ANO.OUT 

NO  auroral  interpreter  output 

DATA 

729 

lines 

113 

ANO.STA 

NO  auroral  states/transitions  file 

DATA 

41 

lines 

114 

ANOP.KIN 

NO'*'  auroral  kinetics  file 

DATA 

626 

lines 

115 

ANOP.OUT 

NO"^  auroral  interpreter  output 

DATA 

689 

lines 

116 

ANOP.STA 

NO'*’  auroral  states/transitions  file 

DATA 

32 

lines 

117 

CH4.BND 

CH4  band  information  file 

DATA 

163 

lines 

118 

CH4.KIN 

CH4  kinetics  file 

DATA 

91 

lines 

119 

CH4.0UT 

CH4  interpreter  output 

DATA 

141 

lines 

120 

CH4.STA 

CH4  states/transitions  file 

DATA 

30 

lines 

121 

CO.BND 

CO  band  information  file 

DATA 

55 

lines 

122 

CO.KIN 

CO  kinetics  file 

DATA 

23 

lines 

123 

CO.OUT 

CO  interpreter  output 

DATA 

52 

lines 

124 

CO.STA 

CO  states/transitions  file 

DATA 

11 

lines 

125 

C021.BND 

CO2  1st  isotope  band  information  file 

DATA 

651 

lines 

126 

C021.KIN 

CO2  1st  isotope  kinetics  file 

DATA 

326 

lines 

127 

C02L0UT 

CO2  1st  isotope  interpreter  output 

DATA 

457 

lines 

128 

C021.STA 

CO2  1st  isotope  states/transitions  file 

DATA 

72 

lines 

129 

C022.BND 

CO2  2nd  isotope  band  information  file 

DATA 

492 

lines 

130 

C022.KIN 

CO2  2nd  isotope  kinetics  file 

DATA 

319 

lines 

131 

C022.0UT 

CO2  2nd  isotope  interpreter  ou^ut 

DATA 

446 

lines 

132 

C022.STA 

CO2  2nd  isotope  states/transitions  file 

DATA 

70 

lines 

133 

C023.BND 

CO2  3rd  isotope  band  information  file 

DATA 

405 

lines 

134 

C023.KIN 

CO2  3rd  isotope  kinetics  file 

DATA 

301 

lines 

135 

C023.0UT 

CO2  3rd  isotope  interpreter  output 

DATA 

422 

lines 

136 

C023.STA 

CO2  3rd  isotope  states/transitions  file 

DATA 

67 

lines 
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137 

H201.BND 

H2O  1st  isotope  band  information  file 

DATA 

213  lines 

138 

H20LKIN 

H2O  1st  isotope  kinetics  file 

DATA 

68  lines 

139 

H201.0UT 

H2O  1st  isotope  interpreter  output 

DATA 

110  lines 

140 

H201.STA 

H2O  1st  isotope  states/transitions  file 

DATA 

27  lines 

141 

H202.BND 

H2O  2nd  isotope  band  information  file 

DATA 

113  lines 

142 

H202.KIN 

H2O  2nd  isotope  kinetics  file 

DATA 

56  lines 

143 

H202.0UT 

H2O  2nd  isotope  interpreter  output 

DATA 

98  lines 

144 

H202.STA 

H2O  2nd  isotope  states/transitions  file 

DATA 

21  lines 

145 

H203.BND 

H2O  3rd  isotope  band  information  file 

DATA 

84  lines 

146 

H203.KIN 

H2O  3rd  isotope  kinetics  file 

DATA 

54  lines 

147 

H203.0UT 

H2O  3rd  isotope  interpreter  output 

DATA 

96  lines 

148 

H203.STA 

H2O  3rd  isotope  states/transitions  file 

DATA 

20  lines 

149 

H204.BND 

H2O  4th  isotope  band  information  file 

DATA 

97  lines 

150 

H204.KIN 

H2O  4th  isotope  kinetics  file 

DATA 

54  lines 

151 

H204.0UT 

H2O  4th  isotope  interpreter  output 

DATA 

96  lines 

152 

H204.STA 

H2O  4th  isotope  states/transitions  file 

DATA 

20  lines 

153 

NO.BND 

NO  band  information  file 

DATA 

55  lines 

154 

NO.KIN 

NO  kinetics  file 

DATA 

18  lines 

155 

NO.  OUT 

NO  interpreter  output 

DATA 

44  lines 

156 

NO.STA 

NO  states/transitions  file 

DATA 

11  lines 

157 

03.BND 

O3  band  information  file 

DATA 

574  lines 

158 

03.KIN 

O3  kinetics  file 

DATA 

244  lines 

159 

03.0UT 

O3  interpreter  output 

DATA 

412  lines 

160 

03.STA 

O3  states/transitions  file 

DATA 

80  lines 

161 

OH.BND 

OH  band  information  file 

DATA 

428  lines 

162 

OH.KIN 

OH  kinetics  file 

DATA 

87  lines 

163 

OH.OUT 

OH  interpreter  output 

DATA 

120  lines 

164 

OH.STA 

OH  states/transitions  file 

DATA 

39  lines 

TEST  CASE  DIRECTORY 


165 

TESTl.INP 

Test  case  1  general  input 

DATA 

695  lines 

166 

TESTl.OUT 

Test  case  1  SHARC-3  general  output 

DATA 

2234  lines 

167 

TESTl.RAD 

Test  case  1  bandpass  radiance  output 

DATA 

1  lines 

168 

TESTl.SPC 

Test  case  1  spectral  radiance  output 

DATA 

2502  lines 

169 

TEST1.TP5 

Test  case  1  MODTRAN  input 

DATA 

105  lines 

170 

TEST1.TP6 

Test  case  1  MODTRAN  general  output 

DATA 

3403  lines 

171 

TEST1.TP7 

Test  case  1  MODTRAN  plotting 

DATA 

2513  lines 

172 

TEST1.TP8 

Test  case  1  MODTRAN  auxiliary  output 

DATA 

11  lines 

173 

TESTl.TRN 

Test  case  1  transmission  data  output 

DATA 

2502  lines 
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174 

TEST2.INP 

Test  case  2  general  input 

DATA 

770  lines 

175 

TEST2.0UT 

Test  case  2  SHARC-3  general  output 

DATA 

5412  lines 

176 

TEST2.RAD 

Test  case  2  bandpass  radiance  ou^ut 

DATA 

1  lines 

177 

TEST2.SPC 

Test  case  2  spectral  radiance  ouQ)ut 

DATA 

9752  lines 

178 

TEST2.TP5 

Test  case  2  MODTRAN  input 

DATA 

105  lines 

179 

TEST2.TP6 

Test  case  2  MODTRAN  general  ou^ut 

DATA 

11321  lines 

180 

TEST2.TP7 

Test  case  2  MODTRAN  plotting 

DATA 

9763  lines 

181 

TEST2.TP8 

Test  case  2  MODTRAN  auxiliary  output 

DATA 

11  lines 

182 

TEST2.TRN 

Test  case  2  transmission  data  ouQ)ut 

DATA 

9752  lines 

183 

TEST3.INP 

Test  case  3  general  input 

DATA 

725  lines 

184 

TEST3.LOG 

Test  case  3  journal  output 

DATA 

40  lines 

185 

TEST3.0UT 

Test  case  3  SHARC-3  general  output 

DATA 

12602  lines 

186 

TEST3.RAD 

Test  case  3  bandpass  radiance  output 

DATA 

1  lines 

187 

TEST3.SPC 

Test  case  3  spectral  radiance  output 

DATA 

9752  lines 

188 

TEST3.TP5 

Test  case  3  MODTRAN  input 

DATA 

105  lines 

189 

TEST3.TP6 

Test  case  3  MODTRAN  general  output 

DATA 

112.33  lines 

190 

TEST3.TP7 

Test  case  3  MODTRAN  plotting 

DATA 

9763  lines 

191 

TEST3.TP8 

Test  case  3  MODTRAN  auxiliary  output 

DATA 

11  lines 

192 

TEST3.TRN 

Test  case  3  transmission  data  output 

DATA 

9752  lines 

193 

TEST4.INP 

Test  case  4  general  input 

DATA 

623  lines 

194 

TEST4.LOG 

Test  case  4  journal  output  (empty) 

DATA 

5  lines 

195 

TEST4.0UT 

Test  case  4  SHARC-3  general  output 

DATA 

5576  lines 

196 

TEST4.RAD 

Test  case  4  bandpass  radiance  ou^ut 

DATA 

1  lines 

197 

TEST4.SPC 

Test  case  4  spectral  radiance  output 

DATA 

142  lines 

198 

TEST4.TP5 

Test  case  4  MODTRAN  input 

DATA 

105  lines 

199 

TEST4.TP6 

Test  case  4  MODTRAN  general  output 

DATA 

817  lines 

200 

TEST4.TP7 

Test  case  4  MODTRAN  plotting 

DATA 

153  lines 

201 

TEST4.TP8 

Test  case  4  MODTRAN  auxiliary  output 

DATA 

11  lines 

202 

TEST4.TRN 

Test  case  4  transmission  data  output 

DATA 

142  lines 

203 

TEST5.INP 

Test  case  5  general  input 

DATA 

653  lines 

204 

TEST5.0UT 

Test  case  5  SHARC-3  general  output 

DATA 

13202  lines 

205 

TEST5.RAD 

Test  case  5  bandpass  radiance  output 

DATA 

1  lines 

206 

TEST5.SPC 

Test  case  5  spectral  radiance  output 

DATA 

162  lines 

207 

TEST5.TP5 

Test  case  5  MODTRAN  input 

DATA 

105  lines 

208 

TEST5.TP6 

Test  case  5  MODTRAN  general  output 

DATA 

885  lines 

209 

TEST5.TP7 

Test  case  5  MODTRAN  plotting 

DATA 

173  lines 

210 

TEST5.TP8 

Test  case  5  MODTRAN  auxiliary  output 

DATA 

11  lines 

211 

TEST5.TRN 

Test  case  5  transmission  data  output 

DATA 

162  lines 
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212 

TEST6.HAZ 

Test  case  6  aerosol  input 

DATA 

1 

lines 

213 

TEST6.INP 

Test  case  6  general  input 

DATA 

793 

lines 

214 

TEST6.0UT 

Test  case  6  SHARC-3  general  output 

DATA 

4869 

lines 

215 

TEST6.RAD 

Test  case  6  bandpass  radiance  output 

DATA 

2 

lines 

216 

TEST6.SPC 

Test  case  6  spectral  radiance  output 

DATA 

19504 

lines 

217 

TEST6.TP5 

Test  case  6  MODTRAN  input 

DATA 

no 

lines 

218 

TEST6.TP6 

Test  case  6  MODTRAN  general  output 

DATA 

23118 

lines 

219 

TEST6.TP7 

Test  case  6  MODTRAN  plotting 

DATA 

19517 

lines 

220 

TEST6.TP8 

Test  case  6  MODTRAN  auxiliary  output 

DATA 

13 

lines 

221 

TEST6.TRN 

Test  case  6  transmission  data  output 

DATA 

19504 

lines 

222 

TEST7.HAZ 

Test  case  7  aerosol  input 

DATA 

1 

lines 

223 

TEST7.INP 

Test  case  7  general  input 

DATA 

1340 

lines 

224 

TEST7.LOG 

Test  case  7  journal  output 

DATA 

21 

lines 

225 

TEST7.0UT 

Test  case  7  SHARC-3  general  output 

DATA 

11252 

lines 

226 

TEST7.RAD 

Test  case  7  bandpass  radiance  output 

DATA 

16 

lines 

227 

TEST7.SPC 

Test  case  7  spectral  radiance  output 

DATA 

14432 

lines 

228 

TEST7.TP5 

Test  case  7  MODTRAN  input 

DATA 

1680 

lines 

229 

TEST7.TP6 

Test  case  7  MODTRAN  general  output 

DATA 

28875 

lines 

230 

TEST7.TP7 

Test  case  7  MODTRAN  plotting 

DATA 

14608 

lines 

231 

TEST7.TP8 

Test  case  7  MODTRAN  auxiliary  output 

DATA 

176 

lines 

232 

TEST7.TRN 

Test  case  7  transmission  data  ou^ut 

DATA 

14432 

lines 

The  FORTRAN  source  code  for  SAMM  resides  in  the 

SAMM 

EXECLTABLE 

directory  along  with  a  sample  make  file.  All  "rootname.H"  files  are  read  into  the  source  with 
include  statements.  The  make  file  lists  which  files  are  included  for  each  source  routine.  All 
the  FORTRAN  files  should  be  compiled  and  linked  to  make  the  executable  version  of  SAMM. 
Since  details  of  make  files  are  system-dependent,  users  will  probably  need  to  edit  "Makefile" 
to  conform  with  their  particular  system’s  standards.  The  open  statements  may  need  to  be 
changed,  again  depending  upon  system  standards.  Files  are  opened  in  the  Samdrv.f,  ambien.f, 
inactv.f,  inutil.f,  modrad.f  and  saminp.f  FORTRAN  routines. 

Atmospheric  profiles  are  found  in  the  ATMOSPHERIC  PROFILES  directory.  The  test 
case  4  and  5  profiles  are  all  outputs  from  sag.f,  the  atmospheric  generator  program. 

The  LINE  AND  BAND  MODEL  DATA  directory  contains  four  separate  FORTRAN 
programs.  The  programs  dirac.f  and  ufmake.f  must  be  compiled,  linked  and  run  to  execute 
SAMM.  The  ufmake.f  program  will  output  a  file  named  "samblk.f".  "samblk.f  should  be 
copied  to  the  SAMM  executable  directory;  it  is  part  of  SAMM’s  source  code,  "ufmake.f"  will 
also  create  the  direct-access,  binary  file  "UFTAPE";  "UFTAPE.ASC"  can  be  removed  once 
"UFTAPE"  has  been  generated.  The  dirac.f  program  will  output  a  file  named  "RECDAT.f; 
this  file  can  be  deleted  since  it  is  not  used,  "dirac.f  will  also  create  the  direct-access,  binary 
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file  "SHARC.H92";  "SHARC.ASC"  can  be  removed  once  "SHARC.H92"  is  created.  The 
programs  linasc.f  and  bmasc.f  can  be  used  to  retrieve  the  ASCII  files.  These  programs  make 
it  unnecessary  to  keep  the  large  ASCII  files  once  the  binary  files  are  created.  Note,  bmasc.f 
reads  samblk.f  as  input,  so  a  copy  of  samblk.f  should  be  kept  in  the  LINE  AND  BAND 
MODEL  DATA  directory. 

The  ATMOSPHERE  GENERATOR  directory  contains  the  SHARC/SAMM 
Atmosphere  Generator  (SAG)  program.  Required  data  files  are  stored  in  the  NRLDAT 
sub-directory.  The  source  is  named  sag.f,  and  the  climatology  data  files  all  have  "NRL" 
(Naval  Research  Laboratory)  as  a  suffix.  Executing  the  SAG  program  requires  a  general  input 
file  named  "drivstor.dat"  and  an  altitude  file.  A  typical  altitude  profile  for  SAMM  is  included 
in  "drivht.sam".  The  files  with  a  "dat"  suffix  are  drivstor.dat  files  for  test  cases  4  and  5. 
Anyone  of  these  files  can  be  copied  into  "drivstor.dat"  and  then  altered  interactively  to 
obtained  the  desired  profile.  The  UNIX  batch  program  "sag. run"  generates  the  test  case  4  and 
5  profiles  found  in  the  atmospheric  profiles  directory.  The  batch  file  assumes  the  SAG 
executable  has  the  name  "sag.exe". 

DEGRAD.f  is  a  filter  function  routine  which  is  found  in  the  FILTER  FUNCTION 
directory.  DEGRAD.f  is  designed  to  process  the  "rootname.SPC"  and  "rootname.TRN" 
SAMM  output  files. 

The  INTERPRETER  in  the  chemical  kinetics  directory  should  be  compiled  as  a  stand 
alone  program.  The  INTERPRETER  subroutines  are  described  in  Appendix  B  of  the 
SHARC-3  manual^^\  and  use  of  the  program  is  discussed  in  Section  7  of  the  manual. 
Appendix  I. 

The  output  files  for  the  seven  test  cases  are  all  included  in  the  TEST  CASE  directory. 
To  run  a  test  case,  the  "rootname.INP"  file  must  be  copied  into  the  SAMM  EXECUTABLE 
directory  as  "SAMM.INP"  and  the  "rootname.HAZ"  file  must  be  copied  into  the  SAMM 
EXECUTABLE  directory  as  "HAZE.INP".  If  no  "rootname.HAZ"  file  exists  (TEST  CASE  1 
through  5),  there  should  be  no  HAZE.INP  in  the  SAMM  EXECUTABLE  directory  when  the 
code  is  run.  This  means  the  calculations  are  being  run  without  aerosols. 

REFERENCES 

1.  R.  D.  Sharma,  J.  W.  Duff,  R.  L.  Sundberg,  J.  H.  Gruninger,  L.  S.  Bernstein, 

D.  C.  Robertson,  S.  M.  Adler-Golden,  M.  W.  Matthew  and  R.  J.  Healey 
(1996),  User’s  Manual  for  SHARC-3,  The  Strategic  High-Altitude  Radiance 
Code,  PL-TR-96-2104 
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APPENDIX  B 


SAMM  PARAMETERS 


For  each  "rootname.H"  file,  a  list  of  the  parameters  is  provided  along  with  a  brief 
definition.  These  parameters  are  included  in  the  various  subroutines  via  FORTRAN  "include" 
statements. 

CNTRL.H 

KMAX  (=63)  The  number  of  LOWTRAN  absorption/scattering  sources. 

FILES. H 

NINP  (=9)  Unit  number  for  MOSART  input  file. 

LDEF  (=10)  Unit  number  for  problem  definition  input  file. 

LATM  (=11)  Unit  number  for  atmospheric  profile  data  file. 

LINK  (=12)  Unit  number  for  linking  (chemical  kinetics)  data  file. 

LBAND  (=13)  Unit  number  for  bands  data  file. 

LRAD  (=14)  Unit  number  for  states/transitions  data  file. 

LINE  (=15)  Unit  number  for  SHARC-3  lines  data  file. 

LSAVE  (=16)  Unit  number  for  populations  data  file. 

LHAZE  (=18)  Unit  number  for  aerosol  data  file. 

LPHASE  (=19)  Unit  number  for  user-supplied  phase  function  data  file. 

NDEF  (=20)  Unit  number  for  writing  out  new  SAMM.INP  file. 

NERR  (=21)  Unit  number  for  journal  output  file. 

NSPEC  (=22)  Unit  number  for  spectral  radiance  output  file. 

NOUT  (=23)  Unit  number  for  SHARC-3  general  output  file. 

NSCR  (=25)  Unit  number  for  scratch  file. 

NSAVE  (=26)  Unit  number  for  saved  population  file. 

NCHK  (=27)  Unit  number  for  file  checking. 

NT  APES  (=28)  Unit  number  for  MODTRAN  input  file. 

NTRAN  (=29)  Unit  number  for  spectral  transmission  output  file. 

NUWU  (=30)  Unit  number  for  Wy  matrix  output  file. 
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HIALT.H 


MXLAY 

MXRAD 

MAXIV 

NSPECS 

LNDAT.H 

MXLIN 

MOSINP.H 

NOPT 

NANTMX 

MLMAX 

PARMS.H 

NPOPMX 

NREGMX 

NENVMX 

NBYMAX 

NRDMX 

NMOLMX 

NISOMX 

NMMAX 

NVMAX 

NSMAX 

NBMAX 

NTMPMX 

NWMAX 

NVARMX 

NCHMAX 

NWRTMX 

NDMAX 

NSEGMX 

NSECMX 

NEDGMX 


=284)  Maximum  number  layer  boundaries  along  LOS. 

(=13)  Maximum  number  of  SHARC  radiator,  isotopes  counted  separately. 
(=31)  Maximum  number  of  vibrational  states  for  a  SH ARC-3  radiator,  or 
maximum  number  of  MODTRAN  radiators,  which  ever  is  larger. 
(=12)  Number  of  species  on  the  band  model  parameter  tape. 


=412)  Maximum  number  of  lines  on  the  SHARC-3  lines  file  in  1  cm'^  bin. 


(=13)  Number  of  MOSART  input  stream  sections. 

(=25)  Maximum  number  of  lines  of  antecedent  input  data. 
=  100)  Maximum  number  of  MOSART  layer  boundaries. 


(=7)  Maximum  number  of  profiles/population  files  for  each  region. 

(=5)  Maximum  number  of  regions. 

(=2)  Maximum  number  of  environments  for  each  region. 

=  106)  Maximum  number  of  layer  boundaries. 

(=16)  Maximum  number  of  SHARC-3  molecular  emitters. 

(=8)  Maximum  number  of  distinct  radiating  molecules. 

(=8)  Maximum  number  of  isotopes  for  each  species. 

(=30)  Maximum  number  of  atmospheric  species. 

(=35)  Maximum  number  of  vibrational  states  for  each  molecular  emitter. 
(=20)  Maximum  number  of  bins  for  band  distributions. 

(=46)  Maximum  number  of  bands. 

(=5)  Maximum  number  of  temperatures  for  band  distributions. 

=200)  Maximum  number  of  frequency  bins  for  the  Voigt  line  shape  function. 
(=20)  Maximum  number  of  variables  for  generic  interactive  read. 

(=80)  Maximum  length  of  reaction  input  string. 

(=20)  Maximum  number  of  types  of  output. 

=400)  Maximum  number  of  non-comment  lines  in  a  SAMM.INP  file. 

(=18)  Maximum  number  of  major  segments  along  a  line  of  sight. 

(=4)  Maximum  number  of  intersections  through  a  single  region. 

(=4)  Maximum  number  of  region  edges. 
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NSTRMX 

(=80) 

NSINMX 

(=5) 

NDMAXM 

(=260) 

MOSDMX 

(=200) 

NBY2MX 

(=232) 

NLYMAX 

(=105) 

NMOL 

(=29) 

NW 

(=200) 

NWUSED 

(=10) 

NFIX 

(=36) 

NFILES 

(=3) 

NEDGE 

(=4) 

NKMAX 

(=95) 

NIMAX 

(=750) 

NLNMAX 

(=15) 

NSPMAX 

(=8) 

NTBMAX 

(=6) 

NRWMAX( 

=9902) 

NIWMAX 

(=115) 

SMLLMX 

(=10) 

NAMLMX 

(=32) 

DIRLMX 

(=64) 

LNGLMX 

(=64) 

LFILMX 

(=132) 

FILLMX 

(=96) 

Maximum  length  of  a  character  string  in  the  defaults  file. 

Maximum  number  of  Curtis-Godson  LOS  through  lower  atmosphere. 
Maximum  number  of  non-comment  MODTRAN  lines  in  a  SAMM.INP  file. 
Maximum  number  of  non-comment  MOSART  lines  in  a  SAMM.INP  file. 
Maximum  number  of  layer  boundaries  along  LOS  in  SHARC  region 
Maximum  number  of  layers 
Maximum  number  of  molecules. 

Maximum  number  of  items  read  from  a  single  line  of  the  input  file. 
Maximum  number  of  items  presently  expected  to  be  read  from 
a  single  line  of  the  input  file. 

The  first  NFIX  data  lines  in  the  input  file,  defining  information 
expected  in  the  same  sequence  in  every  input  file. 

Number  of  types  of  kinetics  files  (linking,  states,  bands). 

Number  of  region  edges. 

Maximum  number  of  species  allowed. 

Maximum  number  of  reactions. 

Maximum  length  of  a  species  symbol. 

Maximum  number  of  species  allowed  in  any  given  reaction. 

Maximum  number  of  third  bodies  allowed  in  any  given  reaction. 

Dimension  of  CHEMKIN  double  precision  work  matrix. 

Dimension  of  CHEMKIN  integer  work  matrix. 

Maximum  number  of  characters  in  prefix/suffix  names. 

Maximum  number  of  characters  for  input/output  file  names. 

Maximum  number  of  characters  for  directory  names. 

Maximum  number  of  characters  for  population  file  names. 

Maximum  number  of  characters  for  full  path  name  of  population  files. 
Maximum  number  of  characters  for  full  path  name  of  files. 


SM.H 

MXCG  (=52)  Maximum  number  of  layers  for  lower  atmosphere  LOS  path. 


TAPES. H 


MXLYRS 

(=33) 

Maximum  number 

MXIREG 

(=4) 

Maximum  number 

MXNANG 

(=50) 

Maximum  number 

MX4 

(=4) 

Maximum  number 

MX47 

(=47) 

Maximum  number 

of  MODTRAN  layer  boundaries, 
of  aerosol  profiles. 

of  angles  in  a  user-defined  phase  function, 
of  different  user-defined  phase  functions, 
of  wavelengths  used  for  tabulating  optical  data. 
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APPENDIX  C 


SAMM  SUBROUTINES 


A  list  of  the  subroutines  comprising  the  various  SAMM  modules  is  given  below. 


Samdrv  .f:  The  DRIVER  Module 


SAMM  Drives  SAMM  calculation.  Makes  primary  calls  to  the  SHARC  and 
MODTRAN  modules,  defines  input  file  as  "SAMM.INP",  and 
deletes  unwanted  output  files. 

SHARC3  Drives  the  SHARC  calculations  in  SAMM. 

MODTRN  Contains  MODTRAN  comments  and  calls  the  MODTRAN  driver 
routine. 


ambien.f;  The  AMBIENT  ENVIRONMENT  Module 


AMBDRV  Calls  the  appropriate  CHEMKIN/NEMESIS  subroutines  to  compute 
the  enhanced  vibrationally  excited  state  populations. 

ARATE  Solves  the  two-state  steady-state  equation  for  the  atmospheric 
excitation  rate  constant. 


CGSUMS 

COLDEN 

CPF12 

DEWV 

WIDTHD 

E2 

EMISS 

ERATE 


Increments  Curtis-Godson  sums. 

Computes  the  total  column  density  for  each  atmospheric  layer  for  the 
radiating  species. 

Calculates  the  real  part  of  the  complex  probability  function  for  a 
Voigt  line  shape. 

Computes  the  equivalent  width  for  a  single  isolated  Voigt  line. 
Calculates  the  Doppler  halfwidth. 

Computes  the  second  exponential  integral  as  a  function  of  optical 
depth. 

Lxxates  the  Einstein  A  coefficient  for  the  current  transition  and 
calculates  the  sum  of  all  Einstein  A  coefficients  for  all  transitions 
from  the  upper  vibrational  state. 

Calculates  the  earthshine  excitation  rate  for  each  atmospheric  layer. 
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ESCPRB 

ESHINE 

FORMV 

WIDTHL 

MULSCT 

NEMDRV 

NEMFAC 

NEMRXN 

N2FAC 

PATH 

PICKS! 

PICKZ 

POPLTE 

QUENCH 

RANF 

SINTRP 


Normalizes  the  escape  probabilities  calculated  by  subroutine  PATH 
for  each  layer. 

Calculates  the  earthshine  flux  for  the  current  transition  using  the 
specified  effective  earthshine  temperature. 

Calculates  the  Voigt  line  shape  function. 

Calculates  the  Lorentz  halfwidth. 

Calculates  the  nth-order  multiple  scattering  enhancement  to  the 
excited-state  number  density  using  the  single-scattering  enhancement 
matrix. 

Drives  computation  of  the  escape  probabilities  and  enhanced 
excited-state  number  densities  for  each  atmospheric  layer  using  Monte 
Carlo  integration  of  atmospheric  layers,  line  strengths,  and 
frequencies. 

Computes  the  probability  of  escaping  a  specified  layer  and  the 
excitation  of  the  layer  from  all  other  layers.  These  quantities  are  used 
for  the  subsequent  auroral  calculation. 

Identifies  the  excitation  and  relaxation  processes  in  the  chemical 
kinetics  mechanism  for  the  current  transition  being  considered  by 
NEMESIS. 

Computes  the  effective  rate  constant  for  the  C02(00011)  +  N2(0) 
quenching  process  and  the  excited  state  populations  for  N2  following 
Kummer  and  James. 

Integrates  through  the  atmospheric  layers  to  determine  the  escape 
probabilities  and  single-scattering  enhancements. 

Determines  the  line  strength  selected  from  the  line  strength 
distribution  function. 

Finds  the  initial  location  and  the  corresponding  layer  for  photon 
emission. 

Computes  the  LTE  populations  for  N2  and  O2  which  are  subsequently 
used  in  the  calculation  of  vibrationally  excited  states  for  CO  and  H2O. 

Computes  the  total  quenching  rate  for  the  upper  state  of  the  transition. 

Generates  uniformly  distributed  random  numbers  between  0  and  1 
(machine-dependent) . 

Performs  a  linear  interpolation  to  obtain  the  line  strength  distribution 
function  for  the  appropriate  layer  temperature. 
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SOLAR 

CGDAT 

SRATE 

STEADY 


VOIGT 

GVLOAD 

GVZERO 

RVLOAD 

RVZERO 


Calculates  the  solar  flux  at  the  transition  frequency  assuming  a 
5500  K  blackbody. 

Calculates  Curtis-Godson  sums  for  determining  attenuation  of  solar 
irradiance  by  repeated  calls  to  MODTRAN. 

Calculates  the  solar  excitation  rate  for  each  atmospheric  layer. 

Sets  up  the  steady  state  rate  equations  and  then  uses  LUDCMP  and 
LUBKSB  to  solve  the  set  of  linear  algebraic  equations  for  the  number 
densities  c^.  The  major  limitation  to  the  steady-state  procedure  used 
here  is  the  assumption  that  the  rate  equations  are  linear  in  the 
unknown  vibrational  population,  that  is,  there  is  no  energy  exchange 
among  the  emitting  species.  This  restriction  can  be  easily  relaxed  by 
using  an  algorithm  which  solves  nonlinear  equations  (as  opposed  to 
LUDCMP/LUBKSB). 

Determines  the  emission  frequency  using  a  Voigt  line  shape  function. 
The  absorption  cross  section  at  this  frequency  is  also  computed. 

Transfers  the  number  densities,  vibrational  transitions,  and  related 
information  from  the  regional  arrays  into  global  arrays,  which  are 
ultimately  used  by  radiative  transport  routines. 

Initializes  all  of  the  global  variable  arrays. 

Transfers  the  number  densities,  vibrational  transitions,  and  related 
information  from  the  local  environment  arrays  into  regional  arrays. 

Initializes  all  of  the  regional  variable  arrays. 


aurora.f:  The  AURORAL  ENVIRONMENT  Module 

ALAM  Computes  Grun’s  universal  energy-dissipation  function  using  a  linear 
interpolation  of  tabulated  values. 

AURDRV  Drives  the  time-dependent  auroral  calculation.  The  auroral  species 
number  densities  are  returned  to  SHARC  main  at  the  observation  time 
specified  by  the  user. 

CKLOAD  Loads  the  populations  computed  during  the  ambient  calculation  as  the 
initial  number  densities  for  the  auroral  species. 

EFFLUX  Calculates  the  primary  energy  flux  assuming  either  a  Gaussian  or 
Maxwellian  distribution  function  for  the  electron  spectra. 
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IPPRAT 


Calculates  the  ion  pair  production  rate  as  a  function  of  altitude  for  the 
specified  auroral  energy  parameters. 

RATMOD  Modifies  the  Einstein  A-coefficients  and  loads  the  layer  excitation 
rates  into  the  appropriate  rate  constant  arrays.  These  quantities  are 
computed  by  the  ambient  calculation. 

TIMDEP  Controls  the  time  dependent  integration  of  the  auroral  rate  equations. 
chmldn.f:  The  CHEMICAL  KINETICS  Module 

ARTCON  Uses  the  kinetic  data  from  the  auroral  linking  file  to  compute  the  rate 
constants  as  a  function  of  temperature  in  exactly  the  same  manner  as 
RATCON  (see  below).  However,  ARTCON  identifies  primary 
electron  processes  and  uses  the  input  ionization  efficiencies  and  the 
ion  pair  production  rate  to  compute  rate  constants  for  secondary 
electron  formation. 

FUN  Supplies  LSODE  with  the  species  production  rates  obtained  from 

PRAT. 

JAC  Supplies  LSODE  with  the  Jacobian  of  the  species  production  rates 

obtained  from  PRATJ. 

LUBKSB/LUDCMP 

Solve  a  set  of  simultaneous  linearly  independent  algebraic  equations 
(the  steady-state  equations)  using  a  LU  (lower/upper)  decomposition 
procedure. 

PRAT  Uses  the  data  obtained  from  the  "linking"  file  to  set  up  the  differential 

equations  for  the  species  production  rates. 

PRATJ  Uses  the  data  obtained  from  the  "linking"  file  to  set  up  the  Jacobian 
of  the  species  production  differential  equations  with  respect  to  the 
species  number  densities. 

RATCON  Uses  the  kinetic  data  from  the  linking  file  to  compute  the  rate 
constants  as  a  function  of  temperature.  The  assumed  form  of  the  rate 
constant  is 

k  =  A  T^  exp(-E/T-C/T^^^)  , 

where  A  is  the  pre-exponential  factor,  /3  is  the  exponent  of  the 
temperature  term,  E  is  the  activation  energy  (can  also  be  used  to  write 
a  reverse  rate  constant  in  terms  of  the  forward  rate  constant  via 
detailed  balance),  and  C  is  the  (historic)  SSH  T^''^  coefficient. 
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LSODE  Numerically  integrates  the  auroral  rate  equations.  The  package  uses 
Gear’s  method  for  stiff  differential  equations  and  is  supplied  with  the 
Sandia  Livermore  CHEMKIN  code.  The  foUowing 
subroutines/functions  are  used  by  the  LSODE  package;  INTDY, 
STODE,  CFODE,  PREPJ,  SOLSY,  EWSET,  VNORM,  DGEFA, 
DGESL,  DGBFA,  DGBSL,  DAXPY,  DSCAL,  DDOT,  IDAMAX, 
DIMACH,  XERRWV.  For  a  brief  description  of  these  routines,  see 
SUBROUTINE  LSODE. 

INTDY  See  LSODE. 

STODE  See  LSODE. 

CFODE  Integrates  the  differential  equations  expressing  the  auroral  model. 

See  LSODE. 

PREPJ  See  LSODE. 

SOLSY  See  LSODE. 

EWSET  See  LSODE. 

VNORM  See  LSODE. 

DGEFA  See  LSODE. 

DGESL  See  LSODE. 

DGBFA  See  LSODE. 

DGBSL  See  LSODE. 

DAXPY  See  LSODE. 

DSCAL  See  LSODE. 

DDOT  See  LSODE. 

IDAMAX  See  LSODE. 

DIMACH  See  LSODE. 

XERRWV  Prints  LSODE-related  error  and  warning  messages.  See  LSODE. 

LSODED  See  LSODE. 

aeolos.f;  The  SHARP  LINE-OF-SIGHT  GEOMETRY  Module 

INGEOM  Reads  LOS  geometry  information  from  the  default  file  and  allows  the 
user  to  review/change  the  parameters. 

SHOGEO  Writes  to  the  screen  the  current  line-of-sight  geometry  input. 

SHOLOS  Writes  to  the  screen  all  line-of-sight  information  at  the  end  of  a 
line-of-sight  menu  session. 
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GETLOC 

GETSOL 

SUBSOL 

RELABS 

GETAZI 

ARCCOS 

ARCSIN 

ARCTAN 

AZI 

CHECKG 

CONDTR 

CONRTD 

CONMTG 

CONGTM 

CONREL 

CONABS 

CROSS 

DOT 

DAZI 


Interactively  determines  a  line-of-sight  in  either  latitude,  longitude 
representation  or  solar  zenith,  azimuth  terms. 

Handles  interactive  input  of  the  point  beneath  the  sun  in  latitude  and 
longitude. 

Computes  solar  latitude  and  longitude  from  the  date  and  time  of  day, 
during  interactive  input. 

Performs  conversions  between  relative  and  absolute  line-of-sight 
specifications. 

Handles  interactive  input  of  local  azimuth  angles  for  a  line-of-sight. 

Checks  argument  of  arccosine  to  make  sure  it  is  between  1.0  and 
-1.0,  then  computes  ACOS. 

Checks  argument  of  arcsine  to  make  sure  it  is  between  1.0  and  -1.0, 
then  computes  ASIN. 

Returns  an  angle  between  0  and  2ir  given  the  end  coordinates  of  a  line 
with  one  vertex  at  the  origin. 

Computes  the  local  azimuth  given  the  latitude  of  two  points  and  the 
angle  between  them. 

Checks  the  geometry  inputs  prior  to  an  calculation. 

Converts  all  angles  to  radians  and  transforms  coordinates  to 
geographic  coordinates. 

Converts  all  angles  to  degrees  and  transforms  coordinates  to  magnetic 
north  pole  coordinates. 

Converts  coordinates  based  on  magnetic  north  pole  to  geographic 
north  pole  coordinates. 

Converts  coordinates  based  on  geographic  north  pole  to  magnetic 
north  pole  coordinates. 

Converts  a  line-of-sight  specified  in  terms  of  solar  zeniths  and 
azimuths  to  latitude  and  longitude  specifications. 

Converts  a  line-of-sight  specified  in  latitudes  and  longitudes  to 
representation  in  terms  of  solar  zeniths  and  azimuths. 

Takes  the  cross  product  between  two  vectors  using  the  right  hand 
rule. 

Takes  dot  product  of  two  vectors. 

Computes  the  local  azimuth  given  the  latitude  of  two  points  and  the 
angle  between  them  (double  precision). 
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DLATI 

DLONGI 

FNDDAY 

FNDGMT 

GEOMEX 

INSroE 

LATI 

LATPHI 

LONGI 

LOS 

MAJSEG 

NORM 

ORDKEY 


ORDRS 

OPSANG 

PLSECT 

PYRINT 

RADE 

RANGER 

REGANG 


Computes  the  latitude  of  point  "I"  in  radians  given  the  latitude  of 
another  point,  "11"  and  the  latitude  of  point  I  to  II  (double  precision). 

Computes  the  longitude  of  point  "I"  in  radians  given  the  longitude  of 
another  point,  "II"  and  the  longitude  of  point  I  to  n  (double 
precision). 

Determines  days  of  year  corresponding  to  solar  latitude. 

Determines  Greenwich  Mean  Time  from  day  of  year  and  solar 
longitude. 

Completes  the  full  (over  complete)  set  of  variables  which  describe  the 
line-of-sight. 

Determines  whether  the  local  region  forms  a  proper  convex  spherical 
pyramid. 

Computes  the  latitude  of  point  "I"  in  radians  given  the  latitude  of 
another  point,  "II"  and  the  latitude  of  point  I  to  II. 

Calculates  the  latitude  and  longitude  of  vector  2  relative  to  vector  1, 
given  the  latitudes  and  longitudes  of  vectors  1  and  2  relative  to  a 
common  vector. 

Computes  the  longitude  of  point  "I"  in  radians  given  the  longitude  of 
another  point,  "11"  and  the  longitude  of  point  I  to  11. 

Determines  the  line-of-sight  vector. 

Determines  the  major  segments  of  the  LOS  through  a  region. 
Normalizes  a  vector  of  length  3. 

Determines  the  relative  order  of  the  elements  of  a  vector,  and  returns 
an  integer  vector  key  containing  the  element  indices  in  order  of 
increasing  element  magnitude. 

Determines  the  order  of  occurrence  of  intersections  of  the  line  of 
sight  with  region  boundaries. 

Computes  the  supplemental  angle. 

Determines  the  intersection  of  a  line-of-sight  vector  with  a  plane. 

Computes  the  segment  boundaries  of  the  LOS  that  are  within  a 
spherical  pyramid. 

Computes  the  earth  radius  as  a  function  of  latitude. 

Computes  the  over  complete  set  of  LOS  geometry  parameters. 

Maps  an  arbitrary  angle  to  a  specified  interval  of  2  x. 
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REGDTR  Converts  edge  latitudes  and  longitudes  to  radians  and  converts  to 
geographic  coordinates  if  necessary. 

REGLOS  Determines  if  observer  or  source  is  inside  the  angular  region. 

SETGEO  Initializes  geometry  parameters. 

UNTVEC  Determines  the  unit  vector  from  latitude  and  longitude. 

VECPOL  Determines  a  cartesian  vector  from  an  altitude,  latitude  and  longitude. 
VECVRT  Determines  polar  coordinates  from  a  cartesian  vector. 


geoseg.f:  The  SHARC  SEGMENT  GEOMETRY  Module 


SEGGEN 

SEGMNT 

PROCAL 

ZNFDGE 


Generates  minor  segments  for  each  major  segment  along  the  specified 
line-of-sight. 

Computes  major  segment  properties,  including  the  major  segment 
lengths,  the  number  of  major  segments,  and  identifies  the  lower 
boundary  for  each  segment. 

Calculates  the  line-of-sight  properties  for  a  major  segment  in  a  single 
region. 

Determines  the  appropriate  profile  column  densities  for  each  segment 
of  the  line-of-sight. 


inactv.f:  The  INTERACTIVE  INPUT  Module 


PROBDF 

ADDREG 

ADDRAD 

CHKREG 

CHKLYR 

CHKPOP 

ALLOLD 

INATM 

INAUR 


Drives  the  interactive  menu  or  batch  execution  of  SAMM,  and 
determines  all  of  the  input  parameters. 

Reviews,  edits  and  adds  regional  information. 

ADDRAD  is  the  input  routine  which  is  used  to  add  radiative  species 
to  the  ambient  and  auroral  population  calculations. 

Checks  all  regional  information,  such  as  filenames  and  input  variable 
prior  to  an  calculation. 

Checks  that  sets  of  boundary  altitudes  of  multiple  profiles  within  a 
region  are  the  same. 

Compares  population  file  content  information  for  consistency  with 
region  data  and  other  profiles  specified  in  SHARC. INP. 

Determines  whether  or  not  all  population  files  are  old. 

Interactively  reviews/changes  the  user’s  choice  of  model  atmosphere. 

Interactively  reviews/changes  the  user’s  choice  of  auroral  conditions. 
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INBOND 

INMOL 

INNAME 

INNEM 

INOUT 

INPOP 

GENTAB 

INREGN 

RMREG 

RMRAD 

INSOL 

INSPEC 

SPCCHK 

INSTDS 

INTITL 

INTYPE 

OPNFLS 

POLL 


Interactively  inputs  the  parameters  which  define  a  local  region. 

Interactively  reviews/changes  the  radiators  included  in  the  population 
calculations. 

Interactively  reviews/changes  the  names  for  the  standard  input  and 
output  files. 

Interactively  reviews/changes  the  input  parameters  for  the  Monte 
Carlo  radiation  trapping  module. 

Allows  the  user  to  review  and/or  modify  the  amount  of  output  written 
to  the  general  output  file. 

Interactively  reviews/changes  the  population  file  names  and  status. 

Generates  the  proper  character  string  for  appending  to  a  standard 
population  file  name. 

Interactively  reviews/changes  regional  information. 

Removes  an  unwanted  region. 

Eliminates  a  radiator  from  the  list  of  species  desired  for  population 
calculation. 

Interactively  changes/reviews  the  solar  zenith  angle. 

Interactively  changes  and/or  modifies  the  spectral  range,  resolution 
and  species  included  in  spectral  radiance  calculation. 

Checks  to  ensure  that  populations  exist  for  all  species  selected  for 
spectral  calculation. 

Supplies  the  menus  for  input  of  name  patterns  and  directories  for 
kinetics,  atmospheric,  population  and  lines  files. 

Interactively  reviews/changes  the  title  of  the  calculation. 

Interactively  changes  the  environment  type.  SAMM  currently  has 
two  environments:  ambient  and  auroral. 

Opens  output  and  line  files. 

Writes  the  main  interactive  menu  for  running  SAMM. 


input,  f:  The  INPUT  Module 

ATMDEN  Loads  atmospheric  profile  into  the  appropriate  local  arrays. 

ATMIN  Identifies  the  atmospheric  species  in  the  general  species  list,  and  reads 
atmospheric  profile  (containing  the  species  number  densities  and 
kinetic  temperature). 
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ATMLYR 

ATMSYM 

BANDIN 

BLKDTS 

BOTCHK 


CKLINK 


POPIN 

RADIN 

REGCHK 

RETREV 

XNUM 


Computes  the  atmospheric  properties  for  each  layer. 

Sets  up  the  character  arrays  identifying  the  atmospheric  species  and  an 
indexing  array  which  relates  the  atmospheric  species  to  the  species 
read  by  CKLINK. 

Reads  the  molecular  bands  file  (Subsection  3.3),  which  describes  the 
line  strength  distribution  function  parameters  for  each  vibrational 
transition. 

Sets  numerous  parameters  concerning  molecular  data. 

Checks  that  the  lowest  altitude  in  an  atmospheric  profile  matches  that 
defined  in  block  data.  This  assures  consistency  within  the  layer  to 
layer  pumping  routine. 

Reads  the  "linking"  file  created  by  INTERP,  and  defines  the  arrays 
containing  information  on  species  names,  chemical  kinetics 
mechanism  (that  is,  the  stoichiometric  coefficients)  and  the  rate 
constants. 

Reads  in  population  file  data  for  CHKPOP. 

Reads  the  molecular  states  file  (Subsection  3.2),  which  contains  the 
molecular  radiator,  the  vibrational  states  included  in  the  mechanism 
and  the  transitions  to  be  considered  by  NEMESIS. 

Checks  region  altitude  boundaries  for  consistency  with  profile 
boundaries. 

Reads  the  saved  population  file  data. 

Translates  an  alphanumeric  character  string  containing  N  integer, 
real,  or  exponential  numbers  into  their  respective  real  values. 


inutil,  f:  The  INPUT  TJllLri'lJbS  Module 


LOADDE  Opens  and  loads  the  input  data  found  in  SAMM.INP  into  the  array 
DFLTS.  If  SAMM.INP  is  not  found,  this  routine  calls  NODFTS  to 
load  in  a  set  of  default  parameters. 

DUMPDE  Writes  the  current  values  of  the  input  variables  into  the  defaults  file. 

NODFTS  Loads  the  default  values  for  a  calculation  into  SHARC.INP  when  an 

SHARC.INP  is  not  found. 


COMOUT  Prints  standard  comments  into  the  defaults  file. 

DFLTSG  Reads  the  regional  information  found  in  the  defaults  file. 

PARSEC  Separates  text  and  numerical  input  parameters  from  an  input  character 

string. 
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RCHECK 

MCHECK 

REDCHR 

REDINT 

REDREL 

SRTMOL 

STUPED 

UPCASE 

LOCASE 

CPYSTR 

LENSTR 

CATSTR 

ITOASC 

WRTSTR 

ACTIVE 

FCHECK 

DCHECK 

KEEPI 

KEEPR 

LENREC 

MRGSTR 

VIBTRN 

VIBES 


Checks  the  range  of  the  variable  to  verify  that  the  variable  value  is 
between  the  given  bounds. 

Checks  the  range  of  the  variable  to  verify  that  the  variable  value  is 
between  the  given  bounds. 

Reads  user  response  to  queries  that  require  character  string  answers. 
Reads  user  response  to  queries  that  require  integer  answers. 

Reads  user  response  to  queries  that  require  real  variable  answers. 

Sorts  molecular  radiators  according  to  AFGL  molecule  number. 

Fills  dflts  array  with  regional  input  information. 

Converts  a  character  string  to  all  upper  case  characters. 

Converts  a  character  string  to  lower  case. 

Copies  one  character  string  into  another. 

Determines  the  non-blank  length  of  a  character  string. 

Concatenates  two  character  strings. 

Converts  an  integer  to  its  ASCII  representation. 

Writes  a  character  string  to  an  internal  file. 

Reads  the  first  data  line  in  the  default  file  to  determine  if  the 
calculation  is  interactive  or  batch. 

Opens  files  and  checks  their  status  against  the  expected  status.  For 
example,  does  a  new  file  already  exist. 

Checks  for  the  existence  of  a  directory. 

Stores  a  copy  of  an  integer  vector. 

Stores  a  copy  of  a  real  vector. 

Determines  the  length  of  records  in  a  direct  access  file. 

Merges  a  character  string  with  another  string. 

Translates  the  vibrational  state  designation  found  in  the  share  line  file 
data  base  to  the  appropriate  index  for  the  population  arrays. 

Converts  1982  HTTRAN  vibrational  assignments  to  1985  format  when 
ICHOIC=l,  and  converts  1985  format  to  1982  vibrational 
assignments  when  ICHOIC=2.  This  routine  is  from  the  HITRAN 
line  selection  program. 
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modaer.f:  The  MQDTRAN  AEROSOLS  Module 


AERNSM 

CIRR18 

FLAYZ 

JOU 

CHECK 

DEFALT 

CONVRT 

WATVAP 

VSANSM 

LAYVSA 

LAYCLD 

MARINE 

DESATT 

CLDPRF 

AERPRF 


Defines  the  lower  atmosphere  molecular,  aerosol  and  cloud  profiles. 

Defines  the  new  cirrus  and  optically  thin  cirrus  profiles. 

Determines  the  final  lower  atmosphere  altitude  boundaries. 

Interprets  the  JCHAR  character  inputs. 

Converts  pressure  and  temperature  to  MODTRAN  standards. 

Chooses  a  stored  atmospheric  profile  and  interpolates  default  values 
for  a  specific  altitude. 

Accommodates  uniform  data  for  MODEL  0  or  7. 

Computes  water  vapor  number  density  (mol/cm^)  to  accommodate 
"JCHAR"  definitions  specified  by  user. 

Drives  Vertical  Structure  Algorithm  routines. 

Determines  atmospheric  layering  for  the  Vertical  Structure 
Algorithm. 

Determines  atmospheric  layering  for  MODTRAN  cloud  models. 

Determines  aerosol  extinction  and  absorption  coefficients  for  the 
Navy  maritime  model. 

Determines  aerosol  extinction  and  absorption  coefficients. 

Defines  standard  cloud  profiles. 

Computes  density  profiles  for  aerosols. 


modblk.f:  The  MODTRAN  BLOCK  DATA  Module 


BLKDAT 

BLKMOD 

MLATMB 

RECDAT 

TITLE 

EXTDTA 

PHSDTA 


Defines  constants  and  routing  arrays  (conversions  between  SHARC, 
HITRAN  and  MODTRAN  labeling  schemes). 

Initializes  fixed  MODTRAN  inputs. 

Defines  model  atmospheric  data  for  six  stored  atmospheric  models. 

Defines  the  frequency  to  record  array  for  the  direct-access  SHARC 
lines  file. 

Defines  titles  for  MODTRAN  output. 

Defines  aerosol  and  cloud  extinction,  absorption  and  asymmetry 
parameters. 

Defines  70  averaged  phase  functions  and  truth  table  identifying 
correct  phase  function. 
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MDTA 

DSTDTA 

CPTRCG 

CPUMEX 

CPH20 

CP03 

moddrv.f:  The 

DRIVR 

PATHAZ 

PSIECA 

RDNSM 

RDEXA 

CIRRUS 

VSA 

STDMDL 

AERTMP 

EXABIN 

EQULWC 

modgeo.f:  The 

GEOM 

GEOMIN 

FNDHMN 


Defines  cloud  and  rain  modeled  atmospheric  data. 

Defines  desert  aerosol  extinction,  absorption  coefficients  and 
asymmetry  parameters  for  4  wind  speeds. 

Defines  Pierluissi  band  model  absorption  coefficients  for  trace  gases. 

Defines  Pierluissi  band  model  absorption  coefficients  for  uniformly 
mixed  gases. 

Defines  Pierluissi  band  model  absorption  coefficients  for  water  vapor. 
Defines  Pierluissi  band  model  absorption  coefficients  for  ozone. 

MODTRAN  DRIVER  Module 

Drives  MODTRAN  calculation  and  read  control  cards. 

Calculates  the  path  azimuth  based  on  latitude  and  longitude  data. 

Calculates  earth  centered  angle  and  path  azimuth  from  an  observer  to 
a  source  point  given  latitude  and  longitude  data. 

Reads  user  input  data  when  user-defined  molecular  profiles  and 
Vertical  Structure  Algorithm  options  are  selected. 

Reads  user-defined  aerosol  or  cloud  input. 

Generates  altitude  profiles  of  cirrus  cloud  density. 

Drives  Army  Vertical  Structure  Algorithm  calculations  of  aerosol 
extinction  and  relative  humidity  for  low  visibility/low  ceiling 
conditions. 

Sets  up  scaled  densities  for  the  model  atmosphere. 

Defines  temperature  for  each  aerosol  altitude  region. 

Loads  aerosol  extinction,  absorption  and  scattering. 

Calculates  liquid  water  content  of  standard  aerosols. 

MODTRAN  REFRACTIVE  GEOMETRY  Module 

Drives  the  low  altitude  air  mass  subroutines,  and  calculates 
attenuation  amounts  for  slant  paths. 

Translates  geometry  input  parameters  into  the  standard  set. 

Calculates  the  minimum  altitude  along  a  path  and  the  zenith  angle  at 
termination. 
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REDUC 

LOCATE 

FBETA 

RPATH 

TANHT 

FILLS 

LAYERS 

RADREF 

FINDSH 

SCALHT 

ANDEX 

EXPINT 

FNDH2 

FTRANG 

DENFAC 

DAWSON 

FACFNC 


Eliminates  slant  path  segments  that  extend  into  the  high  altitude 
regime. 

Locates  latitude  and  longitude  of  point  given  latitude  and  longitude  of 
observer,  earth  centered  angle  and  path  azimuth  at  observer. 

Calculates  the  zenith  angle  at  the  observer  given  observer  and  source 
altitude  and  the  earth  centered  angle. 

Drives  calculation  of  refractive  path  from  observer  to  source. 

Calculates  tangent  height  along  a  refractive  path. 

Defines  the  boundaries  of  the  slant  path  and  interpolates  densities  at 
these  boundaries. 

Calculates  path  length  through  one  layer. 

Computes  the  reciprocal  of  the  radius  of  curvature  as  a  function  of 
altitude. 

Finds  the  scaling  parameters  for  refractive  index  within  a  layer. 
Calculates  coefficient  and  scale  height  for  index  of  refraction. 
Computes  index  of  refraction  at  a  specific  height. 

Performs  exponential  interpolations. 

Finds  the  termination  point  altitude  and  zenith  angle  given  the 
observer  altitude,  zenith  angle  and  range. 

Finds  zenith  angles  at  observer  and  source  given  their  range  and 
altitudes. 

Evaluates  the  integral  from  x=0  to  x=l  of  exp[  -R  (B  x  +  2  A)  x  ]. 

Evaluates  the  integral  from  t=0  to  t=x  of  exp(  t^  -  x^  ). 

Evaluates  0.5  sqrt(T)  exp(z^/b^)  erfc(z/b)  /  b  where  erfc(x)  is  the 
complement  of  the  error  function  evaluated  at  x. 


modlav.f:  The  RADIATIVE  TRANSPORT  LAYER  LOOP  Module 


LOOP 

BBFN 

LAY5DT 

RAIN 

TNRAIN 


Loops  over  layers  for  each  frequency  calculating  radiances  and 
transmittance. 

Calculates  the  Planck  black  body  function  [W/cm^-sr-jttm]. 

Fetches  the  layer  dependent  5  cm'^  resolution  data. 

Fetches  the  extinction,  absorption  and  scattering  coefficients  and  the 
asymmetry  factor  for  rain. 

Calculates  the  extinction  due  to  rain  as  a  function  of  rain  rate. 
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GMRAIN 

AUK 

RNSCAT 

RNTAB 

BS 

DBLTX 

SSRAD 

PHASEF 

HENGNS 

SOURCE 

BMLOAD 

BMFLUX 

FLXADD 

BETABS 

SAMMOD 

SAMLP 

SAMLPO 

SAMWH) 

SAMERF 

SUN 


Computes  attenuation  of  condensed  water  in  the  form  of  rain. 
Performs  aitken  interpolation. 

Calculates  extinction,  scattering  and  asymmetry  parameter  due  to  rain 
in  the  microwave  region. 

Contains  tables  of  rain  data. 

Performs  a  binary  search  to  determine  bracketed  values. 

Calculates  transmittance  from  the  double  exponential  band  model. 

Performs  the  layer  by  layer  single  scattering  radiance  sum. 

Chooses  correct  phase  function  based  on  relative  humidity,  frequency, 
scattering  angle  and  model. 

Calculates  the  phase  function  using  the  Henyey-Greenstein  method. 
Calculates  solar  intensity  date  and  calculates  lunar  intensity. 

Loads  band  model  parameter  data. 

Calculates  upward  and  downward  fluxes  at  1  cm'^  resolution. 

Calculates  upward  and  downward  fluxes  at  5  cm'^  resolution  using  the 
k-distribution  method. 

Supplies  the  back  scatter  fraction  for  a  given  asymmetry  factor  and 
cosine. 

Calculates  molecular  transmittance  at  1  cm'^  resolution. 

Determines  the  band  model  contributions  to  molecular  transmittance 
for  a  multiple  scattering  path. 

Determines  the  band  model  contributions  to  molecular  transmittance 
for  an  optical  path. 

Calculates  the  spectral  bin  Voigt  equivalent  width. 

Returns  a  value  for  "exp(-y*y)  +  sqrt(pi)  *  y  *  erf(y)  -  1"  where  y  is 
the  argument  and  erf  is  the  error  function. 

Evaluates  the  extraterrestrial  solar  irradiance. 


modrad.f:  The  RADIATIVE  TRANSPORT  Module 

TRANS  Drives  radiative  transport  calculations  and  writes  out  results. 

MAPMS  Maps  LOS  layer  indices  into  vertical  path  indices. 

SAMDAT  Calculates  frequency-independent  data  needed  for  the  band  model  and 
line-by-line  molecular  transmittance  calculations. 
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FRQ5DT 

CXDTA 

C4DTA 

ABCDTA 

SLF296 

SLF260 

FRN296 

C6DTA 

C8DTA 

HN03 

FUDGE 

AEREXT 

GAMFOG 

INDX 

DEBYE 

DOP 

HERTDA 

SCHRUN 

O3HH0 

03HH1 

03HH2 

03UV 

02C0NT 


Calculates  the  layer  independent  5  cm'^  data. 

Locates  coefficient  for  double  exponential  band  model. 

Returns  N2  continuum  absorption  coefficient  at  required  wavenumber. 

Moves  double  exponential  coefficients  into  new  arrays. 

Loads  self-broadened  water  vapor  continuum  at  296  K. 

Loads  self-broadened  water  vapor  continuum  at  260  K. 

Loads  foreign-broadened  water  vapor  continuum  at  296  K. 

Returns  Rayleigh  molecular  scattering  attenuation  coefficient  at 
required  wavenumber. 

Returns  Chappuis  ozone  visible  absorption  coefficient  at  required 
wavenumber  (13000  to  24200  cm'^). 

Determines  nitric  acid  absorption  coefficient  at  required  wavenumber. 

Calculates  a  fudge  factor  based  on  the  sum  of  exponentials. 

Interpolates  aerosol  attenuation  coefficients  and  asymmetry  factors  to 
required  wavenumber. 

Computes  attenuation  of  equivalent  liquid  water  content  in  clouds. 

Calculates  the  real  and  imaginary  part  of  refractive  of  the  refractive 
index  of  water. 

Calculates  the  wavenumber  dependence  of  the  dielectric  constant  of 
water. 

Describes  the  real  part  of  the  dielectric  constant  for  water. 

Defines  the  UV  O2  Herzberg  continuum  using  an  analytic  function. 

Determines  the  UV  O2  Schumann-Runge  band  model  parameters. 

Returns  the  constant  term  in  the  UV  O3  Hartley  band  (24370  to  40800 
cm‘^)  temperature  dependent  absorption  coefficient  expansion. 

Returns  the  linear  term  in  the  UV  O3  Hartley  band  (24370  to  40800 
cm‘^)  temperature  dependent  absorption  coefficient  expansion. 

Returns  the  quadratic  term  in  the  UV  O3  Hartley  band  (24370  to 
408(X)  cra'^)  temperature  dependent  absorption  coefficient  expansion. 

Interpolates  UV  O3  data  for  the  40800  to  54054  cm"^  region. 

Interpolates  the  O2  continuum  for  the  1395  to  1760  cm'^  region. 
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modssg.f:  The  SOLAR  SCATTERING  GEOMETRY  Module 


SSGEOM 


SAYRES 


FNDSUN 


SCTANG 


Obtains  attenuation  amounts  for  the  lower  atmosphere  from  scattering 
points  along  optical  path  to  the  extraterrestrial  source. 

Saves  and  restores  optical  path  geometry  and  amount  parameters  in 
preparation  for  solar  path  calculations. 

Determines  subsolar  angles  when  solar  zenith  and  azimuth  at  the 
observer  are  input. 

Returns  solar  azimuth  relative  to  LOS  at  current  scattering  location. 
Returns  the  scattering  angle  at  any  point  along  the  optical  path. 


mosinp.f:  The  MOSART  INPUT  Module 


CHRCBD 

DEVCBD 

F5FMT 

GETATM 

GETVAR 

INTTL 

INMOS 

INPTBD 

INSERT 

LCTRIM 

MOSIN 

OFTNS 

PROMPT 

RDALTS 

RDANTE 

RDATM 


Initializes  MOSART  character  strings. 

Assigns  MOSART  file  unit  numbers. 

Determines  the  x  (0  to  4)  in  format  fS.x  such  that  input  altitudes  (km) 
are  printed  with  the  maximum  possible  number  significant  figures. 

Determines  pressure,  temperature  and  MOSART  species  densities  at 
an  input  altitudes. 

Reads  a  free  format  real  variable  from  an  input  character  string. 

Finds  the  location  of  the  first  non-blank  character  in  a  character 
string. 

Reads  MOSART  inputs  from  array  "DFLMOS"  and  allows  the  user 
to  change  the  data  using  a  menu-query  system. 

Contains  the  MOSART  sample  input  file. 

Inserts  one  character  string  into  another  eliminating  leading  blanks 
and  truncating  if  necessary. 

Trims  any  leading  blanks  from  an  input  character  string. 

Writes  out  the  MOSART  input  file. 

Reviews  and/or  modifies  MOSART  input  options. 

Changes  MOSART  input  data  in  interactive  mode. 

Prompts  user  for  MOSART  user-defined  altitude  grid. 

Prompts  user  for  MOSART  antecedent  input  data. 

Prompts  user  for  MOSART  user-defined  atmosphere  data. 
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RDET  Prompts  user  for  MOSART 

RDH20  Prompts  user  for  MOSART 

RDKEEP  Prompts  user  for  MOSART 

RDNAMS  Prompts  user  for  MOSART 

RDOBS  Prompts  user  for  MOSART 

RDTBCK  Prompts  user  for  MOSART 

RDTERR  Prompts  user  for  MOSART 

RDTHRM  Prompts  user  for  MOSART 

RDUAER  Prompts  user  for  MOSART 

output,  f:  The  SHARP  OUTPUT  Module 


extraterrestrial  source  input  options, 
hydrometer  data, 
keep/delete  file  status  data, 
optional  data  file  names, 
observer  parameters, 
terrain  material  temperatures, 
terrain  specifications, 
source  earth/skyshine  specifications, 
user-defined  aerosol  data. 


AMBOUT 

ATMOUT 

AUROUT 

BANNER 

BNDOUT 

GEMOUT 

GENOUT 

NEMOUT 

POPOUT 

RADOUT 

RETOUT 

SAVE 

SUMOUT 

VBTOUT 

VIBTMP 


Prints  number  densities  for  ambient  molecules. 

Prints  the  atmospheric  profile. 

Prints  the  time  dependent  number  densities  for  an  auroral  calculation. 

Outputs  the  SHARC  banner  identifying  the  run. 

prints  the  line  strength  distribution  function  parameters. 

Writes  out  a  brief  summary  of  the  LOS  information  to 
rootname.OUT. 

Writes  out  a  brief  general  description  of  each  regional  calculation. 

Prints  out  some  of  the  inputs  used  by  NEMESIS. 

Outputs  the  number  densities  as  a  function  of  altitude  for  each 
vibrational  state  in  the  mechanism. 

Outputs  the  information  contained  in  the  molecular  states  file. 

Writes  a  summary  of  the  population  file  to  rootname.OUT  when  an 
old  population  file  is  used  in  a  new  calculation. 

Writes  the  population  file. 

Prints  a  calculational  summary  at  the  beginning  of  each  SAMM  run. 

Outputs  the  vibrational  temperatures  as  a  function  of  altitude  for  each 
vibrational  state  in  the  mechanism. 

Calculates  vibrational  temperatures  of  excited  state  species. 
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samblk.f:  The  BAND  MODEL  PARAMETER  BLOCK  DATA  Module 


SAMBLK  Defines  the  final  frequency  and  number  of  parameter  sets  in  each 
record  in  the  direct-access  band  model  file. 

saminp.f:  The  LOWER  ATMOSPHERE  INPUT  Module 


CRDl 

CRD2 

CRD2IN 

CRD2C 

FINDEX 

XNTRP 

DAYMON 

INMOD 

INSHAR 

IPOPMD 

LOCCUR 

RDIEMS 

RDIRPT 

RDLMOL 

RDNOPR 

RDRUNM 


Interactively  reviews/modifies  MODTRAN  CARDl  inputs. 

Reads  in  aerosol  input  data. 

Reads  in  atmospheric  profiles  for  use  in  lower  atmosphere. 

Drives  determination  of  lower  atmosphere  profiles. 

Determines  the  location  of  the  MODTRAN  molecules  in  the  SHARC 
molecular  density  array. 

Interpolates  to  determine  pressure,  temperature  and  molecular 
densities  to  input  altitude  and  solar  zenith  angle. 

Converts  day  of  year  to  month  and  day  of  month  ignoring  leap  year. 

Reads  MODTRAN  inputs  from  default  file,  calls  routine  to  prompt 
for  changes,  and  stores  final  input  selections. 

Sets  array  indicating  which  SHARC  radiators  are  to  be  included  in 
radiance  calculation. 

Finds  the  population  files  of  the  extended  region  which  have  earth 
centered  angles  to  the  sun  bracketing  the  observer-to-sun  earth 
centered  angle. 

Determines  whether  one  character  string  is  a  substring  of  another 
character  string  ignoring  upper  and  lower  case  differences. 

Allows  the  user  to  review  or  modify  the  type  radiance/ transmittance 
calculation  to  be  performed. 

Allows  the  user  to  change  whether  or  not  a  repeat  run  is  to  be 
performed. 

Allows  the  user  to  review  or  modify  the  MODTRAN  radiator  list. 

AUows  the  user  to  review  or  modify  the  amount  of  output  generated 
in  the  MODTRAN  standard  output  file,  rootname.TPb. 

Allows  the  user  to  review  or  modify  whether  a  SAMM,  MODTRAN 
or  GEOMETRY  ONLY  calculation  is  to  be  performed. 
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RDSALB  Allows  the  user  to  review  or  modify  the  scattering  albedo. 

RDTBND  Allows  the  user  to  review  or  modify  the  boundary  temperature. 

REPEAT  Sets  up  repeat  runs. 

WTCDl  Writes  MODTRAN  CARD  1  data  to  file  TAPES. 

WTCD2  Writes  MODTRAN  CARD  2  data  to  file  TAPES. 

WTCD3  Writes  MODTRAN  CARD  3  data  to  file  TAPES. 

WTCD4S  Writes  MODTRAN  CARD  4  and  CARD  S  data  to  file  TAPES. 
WTTAPS  Writes  MODTRAN  input  data  to  file  TAPES  for  repeat  runs. 


samseg.f:  The  COLUMN  DENSITY  Module 


NLTE  Drives  column  density  calculations  combining  MODTRAN  low 

altitude  column  densities  with  calls  to  SHARC  routines  to  determine 
high  altitude  column  densities. 

GETPOP  fetches  LOS  average  populations  for  each  high  altitude  layer. 

HIGH  determines  high  altitude  column  densities  for  Ite  radiators. 

SAMSS  drives  the  calculation  of  cumulative  absorber  amounts  from  scattering 

points  along  the  optical  path  to  the  extraterrestrial  source. 

VIBSS  calculates  the  vibrational  state  column  densities  for  the  scattering 

point  to  sun  paths. 

HIGHSS  calculates  the  Ite  radiator  column  densities  for  the  scattering  point  to 
sun  paths. 

PTHOUT  prints  out  column  density  data. 

VPLOW  calculates  lower  atmosphere  column  densities. 

RQVIB  returns  the  reciprocal  of  the  vibrational  partition  functions  for  the 
SHARC  radiators. 


-69- 


APPENDIX  D 
TEST  CASES 


-71- 


APPENDIX  D 


TEST  CASES 


SAMM  is  supplied  with  seven  test  cases  to  allow  the  user  to  check  that  it  has  been 
properly  installed,  and  to  demonstrate  some  of  its  features.  The  first  five  test  cases  are 
modeled  after  the  five  SHARC-3  test  cases.  The  input  files  which  define  all  test  cases  are 
supplied;  if  the  user  employs  the  data  files  supplied,  the  resulting  calculation  outputs  should 
match  those  shipped  for  the  cases,  apart  from  minor  roundoff  error.  Appendix  A  lists  the  test 
case  files  and  the  files  are  stored  in  sub-directory  INPDIR  (assuming  a  SAMM  TAR  tape). 
For  each  of  the  seven  test  cases,  there  is  a  general  input  file,  TESTn.INP  (n=l-7);  a  SHARC 
general  output  file,  TESTn.OUT;  spectral  radiance,  transmission  and  bandpass  radiance  files, 
TESTn.SPC,  TESTn.TRN,  and  TESTn.RAD;  a  MODTRAN  input  file,  TESTn.TPS;  and 
MODTRAN  standard,  plotting  and  auxiliary  output  files,  TESTn.TP6,  TESTn.TPT,  and 
TESTn.TPS.  Since  test  case  6  and  7  include  aerosols,  the  HAZE.INP  files  TEST6.HAZ  and 
TEST7.HAZ  are  included  for  these  cases.  Test  cases  3,  4,  and  7  output  warnings  to  the 
journal  file;  for  these  test  cases,  TESTn.LOG  files  have  also  been  included.  The  main  points 
of  interest  for  each  case  are  discussed  here. 

D.l  PREPARATIONS 


To  prepare  for  running  the  test  cases,  the  SAMM  executable  subdirectories 
"DATDIR",  "POPDIR",  "KINDIR",  "OUTDIR”,  and  "ATMDIR"  should  be  created  if  they 
do  not  already  exist.  Test  case  files  (TESTn. extension)  have  been  placed  in  subdirectory 
INPDIR  to  prevent  them  from  being  over  written.  SAMM  output  will  be  written  to  the 
OUTDIR  subdirectory.  All  atmosphere  profiles  should  be  placed  in  the  ATMDIR 
subdirectory.  The  user  should  compile,  link,  and  run  the  INTERPRETER  source  files  from 
subdirectory  KINDIR.  From  DATDIR,  the  ASCH-to-binary  source  files  (dirac.f  and 
ufmake.f)  should  each  be  compiled,  linked,  and  run,  and  the  output  file  "samblk.r  should  be 
moved  up  to  the  SAMM  executable  directory  which  should  contain  the  rest  of  the  SAMM 
FORTRAN  source  files.  The  "POPDIR"  and  "OUTDIR"  subdirectories  must  exist  in 
preparation  for  receiving  output.  If  this  set  of  subdirectories  is  in  some  way  undesirable,  the 
user  will  need  to  modify  the  directory  paths  in  top-level  menu  item  7.  Finally,  the  SAMM 
source  should  be  compiled  and  linked. 
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D.2  THE  TEST  CASES 


D .  2 . 1  First  Test  Case 

For  test  case  1  only,  it  is  not  necessary  to  copy  TESTl.INP  into  the  SAMM  executable 
directory  as  SAMM.INP.  The  SAMM  source  has  the  inputs  for  test  case  1  built  into  the  code 
as  defaults.  Simply  running  SAMM  will  generate  a  SAMM.INP  which  is  identical  to 
TESTl.INP,  assuming  the  executable  directory  does  not  have  either  a  pre-existing 
SAMM.INP  or  HAZE.INP  file.  This  arrangement  insures  that  the  user  will  never  lack  for  an 
input  file  upon  which  to  build.  Without  a  HAZE.INP  input  file,  SAMM  assumes  no  aerosols. 
Once  the  input  file  is  properly  generated,  the  user  can  run  the  test  case  and,  as  for  all  the 
cases,  compare  the  output  files  with  those  shipped.  If  SAMM  is  run  interactively  (entering 
999  from  the  main  menu),  the  journal  file  will  contain  a  warning  noting  no  SAMM.IJIP  file 
was  found  and  that  the  default  had  to  be  used.  If  the  users  exits  the  main  menu  with  an  8,  in 
preparation  for  a  batch  mode  run,  then  the  journal  file,  SAMM.LOG  will  again  contain  this 
warning;  however,  when  SAMM  is  subsequently  run  in  batch  mode,  the  original  journal  file 
will  be  deleted  (since  SAMM.INP  did  exist  for  the  batch  run). 

This  first  case  has  a  nighttime  auroral  region  embedded  in  an  extended  ambient  region. 
The  selection  of  radiators,  NO  and  NO"^,  permit  this  case  to  run  in  a  relatively  brief  time. 
Selected  inputs  and  outputs  from  Test  Case  1  are  reproduced  in  Appendices  E  and  F.  This 
case  matches  SHARC-3  Test  Case  1  except  for  differences  in  spectral  resolution.  The  SAMM 
and  SHARC-3  results  are  compared  at  the  same  resolution  in  Figure  D-1. 

D.2.2  Second  Test  Case 

All  remaining  cases  must  be  run  from  the  supplied  TESTn.INP  files,  which  the  user 
must  copy  to  SAJVIM.INP  in  the  executable  directory.  Again,  the  executable  directory  should 
not  contain  a  HAZE.INP  file  since  this  test  case  does  not  include  aerosols.  The  second  case 
calculates  nighttime  emission  from  all  seven  SHARC  radiators,  but  with  none  of  the 
MODTRAN  only  radiators.  There  should  be  no  journal  file  at  the  end  of  the  run.  This  case  is 
identical  to  the  SHARC-3  Test  Case  2  except  for  differences  in  spectral  resolution.  The 
SAMM  and  SHARC-3  results  are  compared  at  the  same  resolution  in  Figure  D-2.  .A  more 
detailed  comparison  illustrates  that  the  only  significant  differences  arise  for  the  7.65  /zm  CH4 
band.  Figure  D-3.  Since  SH.ARC-3  and  SAMM  use  different  lower  boundaries  for  solving  the 
chemical  kinetics  equations  (50  km  in  SHARC-3  and  30  km  in  SAMM),  they  predict  different 
amounts  of  earthshine  pumping.  Generally  these  differences  are  small.  The  7.65  ^m  CH4 
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band  is  an  exception  in  this  case.  Preliminary  comparisons  to  CIRRIS  data  seem  to  indicate 
better  agreement  with  SAMM,  but  these  results  are  inconclusive  due  to  uncertainties  in  the 
methane  profile. 

D.2.3  Third  Test  Case 

The  third  test  case,  like  the  first,  is  a  nighttime  aurora,  but  with  CO2  added  as  a 
radiator;  only  NO  and  NO"*"  are  calculated  as  in  the  first  test  case.  The  third  test  case 
demonstrates  the  reuse  of  population  files.  The  first  two  cases  generate  new  population  files. 
Being  binary,  these  files  cannot  be  shipped  and  must  be  generated  on  the  user’s  machine.  The 
species  population  information  in  them  can  be  reused  once  generated.  The  third-case  auroral 
calculation  requires  both  ambient  and  auroral  population  files.  Instead  of  being  generated 
anew,  however,  the  ambient  file  is  that  created  by  the  second  test  case.  That  file,  POP2. 180, 
must  have  been  previously  generated  by  the  second  case  and  left  in  the  POPDIR  subdirectory 
in  order  for  the  third  case  to  run.  The  third  case  creates  its  own  auroral  population  file 
POP3A.180.  Test  Case  3  outputs  a  warning  in  the  journal  file  indicating  that  vibrational  state 
populations  have  been  determined  for  molecules  not  included  in  the  radiator  list.  That  is, 
POP2. 180  generated  vibrational  distributions  for  all  species,  but  only  NO,  NO"  and  CO2  have 
been  included  in  the  radiator  list.  This  case  matches  SHARC-3  Test  Case  3  except  for 
differences  in  spectral  resolution.  The  SAMM  and  SHARC-3  results  are  compared  at  the  same 
resolution  in  Figure  D-4. 

D.2.4  Fourth  Test  Case 

The  fourth  and  fifth  test  cases  demonstrate  the  use  of  multiple  atmospheric  profiles  to 
model  the  terminator.  The  atmosphere  generator  was  used  to  write  seven  files  representing 
solar  zenith  angles  from  91°  to  102°,  essentially  bracketing  the  change  in  ozone  vibration  state 
densities  at  high  latitudes.  The  atmosphere  names  are  'T4Z(solar  zenith  angle).. ATM"  where 
the  solar  zenith  angle  is  a  3  digit  integer  between  091  and  102.  The  test  case  calculates  the 
radiance  of  O3,  whose  concentration  is  sensitive  to  solar  illumination.  The  LOS  for  the  first 
three  test  cases  are  limb  views;  the  LOS  starts  and  ends  at  the  maximum  300  km  altitude, 
capturing  radiation  from  the  entire  atmosphere  above  the  tangent  altitude.  This  test  case  uses 
an  observer  to  space  LOS;  the  obsers’er  is  located  at  184  km  and  looks  downward  jirough  the 
tangent  point  at  96  km  and  back  up  to  300  km.  This  case  matches  SHARC-3  Tesi  Case  4 
except  for  differences  in  spectral  resolution.  The  SAMM  and  SHARC-3  results  are  compared 
at  the  same  resolution  in  Figure  D-5. 
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D.2.5  Fifth  Test  Case 


The  fifth  case  also  uses  seven  profiles  to  model  a  terminator  LOS.  Presently,  seven  is 
the  maximum  number  of  profiles  allowed  for  a  single  region  (increase  NPOPMX  in 
FARMS. H  to  allow  for  more  profiles).  The  atmosphere  names  are  ’’T5Z(solar  zenith 
angle). ATM".  The  observer  is  in  about  the  same  location  as  in  the  fourth  case,  slightly  higher 
at  250  km.  The  radiators  are  the  three  most  prominent  isotopes  of  CO2.  This  case  matches 
SHARC-3 .  Test  Case  5  except  for  differences  in  spectral  resolution.  The  SAMM  and 
SHARC-3  results  are  compared  at  the  same  resolution  in  Figure  D-6. 

D.2.6  Sixth  Test  Case 

The  sixth  test  case  is  considerably  different  from  the  first  five  test  cases.  This  test  case 
includes  aerosols,  so  it  is  necessary  to  copy  TEST6.HAZ  into  the  executable  directory  as 
HAZE.INP.  Test  case  6  performs  a  low  altitude  daytime  calculation  (limb  LOS  tangent  at  10 
meters  altitude)  with  all  SH.AlRC  and  MODTRAN  radiators,  and  uses  the  repeat  run  option  to 
compare  SAMM  combined  LBL/band  model  results  to  MODTRAN  band  model  only  results. 
Solar  and  thermal  single  and  multiple  scattering  is  included  in  the  calculations.  Agreement  is 
excellent  in  all  regions  except  the  center  of  the  4.3  nm  band,  where  near  field  hot  CO2 
significantly  contributes  to  the  spectral  radiance.  The  complete  SAMM  and  MODTRAN 
results  are  compared  in  Figure  D-7.  In  Figure  D-8,  the  4.3  fim  region  is  plotted  on  a  more 
expanded  scale  in  order  to  show  the  differences  between  SAMM  and  MODTRAN. 

D.2.7  Seventh  Test  Case 

The  seventh  test  case  demonstrates  how  SAMM  is  used  to  calculate  bandpass  radiance 
profiles.  Again  for  this  case  it  is  necessary  to  copy  TEST7.HAZ  into  HAZE.IN?.  In  this 
run,  a  localized  auroral  region  is  centered  65°  north  of  the  equator  and  at  0°  longitude.  The 
aurora  extends  from  80  to  160  km  altitude.  Sixteen  limb  calculations  are  performed  with 
tangent  heights  separated  by  8  km  from  ground  to  120  km  altitude.  All  radiators  are  included 
in  the  calculations.  The  tangent  point  is  located  at  the  center  of  the  aurora,  65°  North  and 
0°  East.  The  LOS  travels  directly  west  at  the  tangent  point.  SAMM,  SKARC,  and 
MODTRAN  predictions  are  compared  in  Figure  D-9  for  the  bandpass  extending  from  1500  to 
2400  cm'^ 
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WAVELENGTH  (jim) 

Figure  D-2.  SAMM/SHARC  Test  Case  2  Comparison. 
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Figure  D-3.  SAMM/SHARC  Test  Case  2  Comparison  for  the  7.65  fim  Band  of  CH4. 
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Figure  D-4.  SAMM/SHARC  Test  Case  3  Comparison. 
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Figure  D-5.  SAMM/SHARC  Test  Case  4  Comparison. 
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Figure  D-6.  SAMM/SHARC  Test  Case  5  Comparison. 
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Figure  D-7.  SAMM/MODTRAN  Test  Case  6  Comparison. 
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Figure  D-8.  SAMM/MODTRAN  Test  Case  6  Comparison  in  the  4  Region. 
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RADIANCE  (W/CM^-SR) 

Figure  D-9.  SAMM/SHARC/MODTRAN  Test  Case  7  Comparison  for  the  4.2  to 
6.7  ;tm  Bandpass. 
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APPENDIX  E 


SAMM  MID-LATITUDE  NIGHT-TIME  ATMOSPHERIC  PROFILE 


ATMOSPHERE  SAMM 

MIDLAT.NIG 

END 

NUMBER  OF  LAYERS 
102 
END 

EXOATMOSPHERIC  TEMPERATURE 
1000.0 
END 

SPECIES 

N2  02  0  C02  CO  H20  NO  03  H 


END 

ALTITUDES 


0.0 

1.0 

2.0 

3.0 

5.0 

6.0 

7.0 

8.0 

10.0 

11.0 

12.0 

13.0 

15.0 

16.0 

17.0 

18.0 

20.0 

25.0 

21.0 

22.0 

23.0 

30.0 

32.0 

34.0 

36.0 

40.0 

42.0 

44.0 

46.0 

50.0 

52.0 

54.0 

56.0 

60.0 

62.0 

64.0 

66.0 

70.0 

72.0 

74.0 

76.0 

80.0 

82.0 

84.0 

86.0 

90.0 

92.0 

94.0 

96.0 

100.0 

102.0 

104.0 

106.0 

110.0 

112.0 

114.0 

116.0 

120.0 

122.0 

124.0 

126.0 

130.0 

132.0 

134.0 

136.0 

140.0 

142.0 

144.0 

146.0 

150.0 

160.0 

170.0 

180.0 

200.0 

210.0 

220.0 

230.0 

250.0 

300.0 

260.0 

270.0 

280.0 

END 


OH  N20  CH4  N02  S02  NH3  HN03 


4.0 

9.0 

14.0 

19.0 

24.0 

38.0 

48.0 

58.0 

68.0 

78.0 

88.0 

98.0 

108.0 

118.0 

128.0 

138.0 

148.0 

190.0 

240.0 

290.0 
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TEMPERATURES 
2.8820E+02  2 
2.5570E+02  2 
2.2330E+02  2 
2.1670E+02  2 
2.1670E+02  2 
2.2160E+02 
2.2650E+02  2 
2.5040E+02  2 
2.7065E+02  2 
2.4706E+02  2 
2.1959E+02  2 
1.9861E+02  1 
1.8687E+02  1 
1.9508E+02  1 
2.4000E+02  2 
3.6000E+02  3 
4.6927E+02  4 
5.5932E+02  5 
6.3439E+02  6 
8.5456E+02  8 
9.3338E+02  9 
9.7601E+02 

END 

N2  DENSITIES 
1.9900E+19  1 
1.1965E+19  1 
6.7182E+18  5 
3.1631E+18  2 
1.4441E+18  1 
6.5112E+17 
2.9912E+17  2 
6.4901E+16  4 
1.6700E+16  1 
5.0401E+15  3 
1.3487E+15  1 
3.0067E+14  2 
5.5470E+13  3 
9.2100E+12  6 
1.6410E+12  1 
3.7260E+11  2 
1.3260E+11  1 
6.0090E+10  5 
3.1240E+10  1 
2.9250E+09  1 
4.8260E+08  3 
9.5930E+07 

END 


.8170E+02 

.4920E+02 

.1680E+02 

.1670E+02 

.1760E+02 

.2930E+02 
.5590E+02 
.  6900E+02 
.4157E+02 
.  1426E+02 
.9470E+02 
.8698E+02 
.9953E+02 
.  6400E+02 
.8355E+02 
.8838E+02 
.7573E+02 
.9629E+02 
.7679E+02 
.5099E+02 


.8065E+19 

.0723E+19 

.9270E+18 

.7038E+18 

.2301E+18 

. 1427E+17 
.8696E+16 
.3200E+16 
.9179E+15 
. 0158E+15 
. 1859E+14 
.8860E+13 
.5080E+12 
.1580E+12 
.9470E+11 
.1160E+11 
.2250E+10 
.7740E+10 
.9890E+09 
.4590E+08 


2.7520E+02 

2.4270E+02 

2.1670E+02 

2.1670E+02 

2.1860E+02 

2.3388E+02 

2.6142E+02 

2.6350E+02 

2.3607E+02 

2.1035E+02 

1.9078E+02 

1.8774E+02 

2.0531E+02 

2.8800E+02 

4.0622E+02 

5.0748E+02 

5.9095E+02 

7.4757E+02 

8.9901E+02 

9.5724E+02 


1.6354E+19 

9.5907E+18 

5.0679E+18 

2.3118E+18 

1.0481E+18 

1.5883E+17 

3.6741E+16 

1.0400E+16 

3.0285E+15 

7.5547E+14 

1.5792E+14 

2.7150E+13 

4.6090E+12 

8.4220E+11 

2.3680E+11 

9.4600E+10 

4.5650E+10 

1.0700E+10 

1.3730E+09 

2.4940E+08 


2.6870E+02 

2.3620E+02 

2.1670E+02 

2.1670E+02 

2.1960E+02 

2.3904E+02 

2.6674E+02 

2.5800E+02 

2.3058E+02 

2.0643E+02 

1.8687E+02 

1.8931E+02 

2.1289E+02 

3.1200E+02 

4.2804E+02 

5.2519E+02 

6.0617E+02 

7.9007E+02 

9.0739E+02 

9.6350E+02 


1.4769E+19 

8.5441E+18 

4.3314E+18 

1.9759E+18 

8.9346E+17 

1.1945E+17 

2.7915E+16 

8.1700E+15 

2.3272E+15 

5.5885E+14 

1.1335E+14 

1.8940E+13 

3.2730E+12 

6.2850E+11 

1.9300E+11 

8.0800E+10 

4.0070E+10 

6.7400E+09 

9.6000E+08 

1.8060E+08 


2.6220E+02 

2.2970E+02 

2.1670E+02 

2.1670E+02 

2.2060E+02 

2.4438E+02 
2.7062E+02 
2.5250E+02 
2.2509E+02 
2. 0252E+02 
1.8687E+02 
1.9172E+02 
2.2329E+02 
3.3600E+02 
4.4904E+02 
5.4290E+02 
6.2028E+02 
8.2531E+02 
9. 1578E+02 
9. 6976E+02 


1.3308E+19 
7.5905E+18 
3.7012E+18 
1. 6893E+18 
7. 6265E+17 

8.9279E+16 
2. 1423E+16 
6.4000E+15 
1.7774E+15 
4. lllOE+14 
7.9150E+13 
1.3200E+13 
2. 3270E+12 
4,7940E+11 
1.5920E+11 
6. 9470E+10 
3.5310E+10 
4. 3850E+09 
6.7780E+08 
1. 3140E+08 
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02  DENSITIES 
5.3253E+18 
3.2019E+18 
1.7978E+18 
8.4645E+17 
3.8644E+17 
1.7424E+17 
8.0047E+16 
1.7368E+16 
4.4600E+15 
1.3521E+15 
3.6181E+14 
8.0661E+13 
1.4790E+13 
2.1510E+12 
2.6210E+11 
4.3950E+10 
1.3750E+10 
5.7020E+09 
2.7500E+09 
1.9180E+08 
2.4820E+07 
3 .9420E+06 

END 

O  DENSITIES 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
l.OOOOE+04 
l.OOOOE+06 
l.OOOOE+08 
l.OOOOE+10 
2.4430E+11 
4.2980E+11 
2.3030E+11 
9.2750E+10 
4.6250E+10 
2.7290E+10 
1.7800E+10 
4.0500E+09 
1.3880E4-09 
5.4330E+08 

END 


4.8342E+18 

2.8696E+18 

1.5861E+18 

7.2356E+17 

3.2917E+17 

5.7340E+16 

1.3031E+16 

3.5200E+15 

1.0510E+15 

2.7251E+14 

5.8641E+13 

1.0270E+13 

1.4300E+12 

1.7060E+11 

3.3600E+10 

1.1340E+10 

4.8810E+09 

1.4600E+09 

1.2390E+08 

1.7000E+07 


0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

2.5100E+04 

2.5119E+06 

2.5119E+08 

2.0488E+10 

3.4340E+11 

4.0070E+11 

1.8890E+11 

7.9250E+10 

4.1180E+10 

2.4890E+10 

1.2380E+10 

3.2110E+09 

1.1430E+09 


4.3765E+18 

2.5665E+18 

1.3562E+18 

6.1864E+17 

2.8048E+17 

4.2505E+16 
9.8320E+15 
2.7800E+15 
8.1245E+14 
2.0267E+14 
4.2366E+13 
7.0600E+12 
9.4340E+11 
1.1560E+11 
2. 6250E+10 
9.4440E+09 
4.1990E+09 
8.2770E+08 
8. 1450E+07 
1. 1710E+07 


0. OOOOE+00 
0. OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 

0. OOOOE+00 
O.OOOOE+00 
6.3100E+04 
6.3096E+06 
6. 3096E+08 
4.1976E+10 
4.1590E+11 
3.6190E+11 
1.5650E+11 
6.8400E+10 
3.6880E+10 
2.2780E+10 
8.9960E+09 
2.5730E+09 
9.4470E+08 


3.9522E+18 

2.2865E+18 

1.1591E+18 

5.2877E+17 

2.3910E+17 

3 .1966E+16 
7.4702E+15 
2.1900E+15 
6.2433E+14 
1.4992E+14 
3 .0310E+13 
4.8010E+12 
6.1890E+11 
8.1200E+10 
2 .0870E+10 
7.9270E+09 
3.6310E+09 
4.9210E+08 
5.4250E+07 
8.1100E+06 


0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

1.5800E+05 

1.5849E+07 

1.5849E+09 

8.6000E+10 

4.4710E+11 

3.1880E+11 

1.3050E+11 

5.9560E+10 

3.3200E+10 

2.0920E+10 

6.7470E+09 

2.0810E+09 

7.8340E+08 


3.5614E+18 

2.0313E+18 

9.9045E+17 

4.5207E+17 

2.0409E+17 

2.3891E+16 

5.7329E+15 

1.7100E+15 

4.7682E+14 

1.1029E+14 

2.1200E+13 

3.2300E+12 

4.0450E+11 

5.8920E+10 

1.6830E+10 

6.7020E+09 

3.1530E+09 

3.0310E+08 

3.6530E+07 

5.6430E+06 


0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 

O.OOOOE+00 
0. OOOOE+00 
3.9800E+05 
3.9811E+07 
3.9811E+09 
1.5130E+11 
4.4760E+11 
2.7480E+11 
1.0960E+11 
5.2290E+10 
3.0040E+10 
1.9270E+10 
5.1810E+09 
1.6950E+09 
6.5160E+08 
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C02  DENSITIES 
8.4084E+15  7. 
5.0556E+15  4. 
2.8387E+15  2. 
1.3365E+15  1. 
6.1017E+14  5. 
2.7512E+14 
1.2639E+14  9. 
2.7423E+13  2. 
7.0500E+12  5. 
2.0268E+12  1. 
5.4235E+11  4. 
1.2091E+11  8. 
2.2380E+10  1. 
3.7193E+09  2. 
6.3096E+08  3. 
7.7452E+07  5. 
1.7785E+07  1. 
5.6699E+06  4. 
2.1781E+06  9. 
6.2601E+04  3. 
3.8811E+03  2. 
3.0983E+02 
END 

CO  DENSITIES 
3.8220E+12  3. 
1.9962E+12  1. 
8.5693E+11  6. 
1.5961E+11  1. 
2.4610E+10  1. 
1.2489E+10 
6.5493E+09  4. 
2.0750E+09  1. 
9.8300E+08  9. 
9.0000E+08  1. 
1.6800E+09  1. 
1.8300E+09  1. 
7.8100E+08  6. 
2.2300E+08  1. 
4.7000E+07  3. 
1.5300E+07  1. 
6.8300E+06  5. 
3.3000E+06  2. 
1.8500E+06  1. 
1.9500E+05  1. 
3.8000E+04  3. 
1.2900E+04 
END 


6329E+15 

5309E+15 

5044E+15 

1425E+15 

1975E+14 

0537E+13 

0576E+13 

5600E+12 

5755E+12 

0849E+11 

7901E+10 

5679E+10 

5999E+09 

8519E+08 

5552E+07 

3878E+07 

6236E+06 

4394E+05 

4781E+04 

2906E+03 


3538E+12 

7684E+12 

8028E+11 

0625E+11 

9404E+10 

9963E+09 

7180E+09 

1300E+08 

0500E+09 

8400E+09 

6800E+09 

7200E+08 

6300E+08 

5900E+07 

2600E+07 

8100E+06 

9100E+06 

0900E+06 

3000E+05 

0200E+04 


6.9102E+15 

4.0524E+15 

2.1414E+15 

9.7680E+14 

4.4286E+14 

6.7113E+13 

1.5524E+13 

4.3900E+12 

1.2178E+12 

3.0380E+11 

6.3505E+10 

1.0958E+10 

1.8222E+09 

2.4553E+08 

4.0724E+07 

1.0934E+07 

3.7995E+06 

4.4431E+05 

1.9643E+04 

1.3793E+03 


2.9295E+12 

1.5313E+12 

5.0705E+11 

7.3674E+10 

1.6533E+10 

3.9532E+09 

1.4429E+09 

8.2900E+08 

1.2500E+09 

1.9200E+09 

1.5100E+09 

5.1000E+08 

1.2000E+08 

2.8000E+07 

1.0600E+07 

5.0000E+06 

2.5700E+06 

7.0000E+05 

9.0700E+04 

2.4200E+04 


6.2403E+15 

3.6102E+15 

1.8302E+15 

8.3490E+14 

3.7752E+14 

5.0473E+13 

1.1795E+13 

3.4500E+12 

9.3586E+11 

2.2473E+11 

4.5582E+10 

7.6444E+09 

1.2809E+09 

1.6228E+08 

3.0420E+07 

8.7128E+06 

3.1382E+06 

2.2195E+05 

1.1394E+04 

8.3449E+02 


2.5510E+12 

1.2964E+12 

3.5350E+11 

4.9740E+10 

1.4952E+10 

3.1980E+09 

1.2237E+09 

7.7900E+08 

1.4300E+09 

1.9600E+09 

1.2800E+09 

4.0000E+08 

8.7600E+07 

2.2500E+07 

9.0400E+06 

4.3200E+06 

2.2900E+06 

4.7000E+05 

6.5700E+04 

1.9400E+04 


5.6232E+15 

3.2073E+15 

1.5639E+15 

7.1379E+14 

3.2224E+14 

3.7723E+13 

9.0519E+12 

2.7100E+12 

7.1474E+11 

1.6532E+11 

3.1936E+10 

5.3303E+09 

9.0199E+08 

1.1063E+08 

2.3095E+07 

6.9961E+06 

2.6089E+06 

1.1589E+05 

6.6526E+03 

5.0729E+02 


2.2356E+12 

1.0633E+12 

2.3813E+11 

3.3505E+10 

1.3671E+10 

2.5981E+09 

1.0638E+09 

7.4400E+08 

1.5500E+09 

1.9300E+09 

l.OOOOE+09 

3.0000E+08 

6.4400E+07 

1.8400E+07 

7.7500E+06 

3.7600E+06 

2.0500E+06 

2.9800E+05 

4.8900E+04 

1.5800E+04 
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H20  DENSITIES 
1.9734E+17  1. 
2.1402E+16  1. 
6.0180E+14  2. 
2.0250E+13  1. 
7.2111E+12  6. 
3.6891E+12 
1.8097E+12  1. 
4.1758E+11  3. 
1.1200E+11  8. 
3.3500E+10  2. 
7.9200E+09  5. 
1.0600E+09  6. 
6.1400E+07  3. 
3.7700E+06  2. 
2.5600E+05  1. 
2.0400E+04  1. 
7.7100E+03  6. 
3.7200E+03  3. 
2.0700E+03  1. 
2.8700E+02  2. 
7.6000E+01  6. 
2.6000E+01 
END 

NO  DENSITIES 
7.6440E+09  6. 
4.5960E+09  4. 
2.5806E+09  2. 
1.1462E+09  9. 
4.7150E+08  4. 
5.7108E+08 
9.3835E+08  1. 
9.3072E+08  7. 
2.2000E+08  1. 
6.4902E+07  5. 
1.9814E+07  1. 
1.0269E+07  1. 
2.5663E+07  3. 
7.2242E+07  7. 
7.8731E+07  7. 
5.4900E+07  4. 
2.1700E+07  1. 
8.3400E+06  7. 
4.1100E+06  2. 
2.6500E+05  1. 
3.2800E+04  2. 
4.0000E+03 
END 


4042E+17 

2706E+16 

7419E+14 

3675E+13 

2606E+12 

3182E+12 

1953E+11 

7300E+10 

6000E+10 

7500E+09 

5800E+08 

4400E+07 

3400E+06 

3700E+05 

6300E+04 

5700E+03 

2800E+03 

2600E+03 

1300E+02 

OOOOE+01 


9390E+09 

1190E+09 

2767E+09 

2782E+08 

3628E+08 

0991E+09 

3303E+08 

7200E+08 

0625E+07 

6964E+07 

0927E+07 

2704E+07 

5363E+07 

5313E+07 

8300E+07 

7400E+07 

1900E+06 

0600E+06 

7500E+05 

1500E+04 


9.6973E+16 

7.0242E+15 

1.2368E+14 

1.1396E+13 

5.4552E+12 

9.9039E+11 

2.4438E+11 

6.8200E+10 

2.0400E+10 

3.8700E+09 

3.5900E+08 

1.8400E+07 

1.4200E+06 

6.6900E+04 

1.3300E+04 

5.6300E+03 

2.9000E+03 

8.2200E+02 

1.6100E+02 

4.8000E+01 


6.2820E+09 

3.6840E+09 

1.9467E+09 

7.4592E+08 

4.1199E+08 

1.2105E+09 
5.5415E+08 
1.3400E+08 
3.9488E+07 
1.4523E+07 
1.1627E+07 
4.1846E+07 
7.7797E+07 
7.3370E+07 
4. 1500E+07 
1.4400E+07 
6.2500E+06 
1.0500E+06 
1.1500E+05 
1.4100E+04 


6.0172E+16 

4.0117E+15 

6.0174E+13 

9.6773E+12 

4.8048E+12 

7.5249E+11 
1.8711E+11 
5.2600E+10 
1.5100E+10 
2.6100E+09 
2.0300E+08 
1.0500E+07 
8.4200E+05 
3.3600E+04 
1.0900E+04 
4.8800E+03 
2.5800E+03 
5.6000E+02 
1.2400E+02 
3 .9000E+01 


5.6730E+09 
3 .2820E+09 
1.6583E+09 
6.0720E+08 
4.1184E+08 

1.2159E+09 
4.0800E+08 
1.0600E+08 
3 .1146E+07 
1.2734E+07 
1.5138E+07 
5.2882E+07 
7.7797E+07 
6.7500E+07 
3 .3500E+07 
1.1900E+07 
5.4300E+06 
6.1000E+05 
7.5900E+04 
9.2800E+03 


3.6772E+16 

1.5385E+15 

2.8088E+13 

8.3275E+12 

4.1989E+12 

5.6756E+11 

1.4387E+11 

4.1000E+10 

1.0900E+10 

1.6800E+09 

1.1400E+08 

6.3400E+06 

4.8100E+05 

2.6000E+04 

9.1300E+03 

4.2500E+03 

2.3100E+03 

3.9500E+02 

9.6400E+01 

3.2000E+01 


5.1120E+09 

2.9157E+09 

1.3980E+09 

5.2777E+08 

4.4040E+08 

1.1072E+09 

2.9779E+08 

8.2800E+07 

2.4842E+07 

1.1436E+07 

1.9711E+07 

6.1872E+07 

7.8731E+07 

6.1100E+07 

2.7000E+07 

9.8500E+06 

4.7200E+06 

4.0200E+05 

5.0000E+04 

6.0900E+03 
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03  DENSITIES 
6.7777E+11  6 
5.7726E+11  5 
1.1294E+12  1 
2.6345E+12  3 
4.7686E+12  4 
4.2669E+12 
2.5098E+12  1 
6.0663E+11  3 
6.6400E+10  3 
7.3000E+09  4 
3.8000E+08  1 
3.6000E+08  4 
4.1000E+08  3 
3.6000E+07  1 
5.6500E+05  1 
3.1000E+03  1 
1.5000E+02  9 
1.8000E+01  1 
4.5000E+00  1 
3.7000E-02  2 
3.1000E-03  2 
4.4000E-04 

END 

H  DENSITIES 
O.OOOOE+00  0 
O.OOOOE+00  0 
O.OOOOE+00  0 
O.OOOOE+00  0 
O.OOOOE+00  0 
O.OOOOE+00 
O.OOOOE+00  0 
O.OOOOE+00  0 
4.4600E-02  9 
4.5000E+00  5 
8.9600E+00  9 
9.4500E+06  7 
5.6000E+07  6 
2.8700E+07  2 
7.5600E+06  6 
2.5100E+06  2 
9.1200E+05  8 
3.8800E+05  3 
1.6000E+05  7 
4.0800E+03  2 
1.7400E+02  1 
9.7300E+00 

END 


.7794E+11 
. 6458E+11 
. 6309E+12 
.0123E+12 
.7691E+12 

.9757E+12 
.9941E+11 
.8400E+10 
.8000E+09 
.7000E+08 
.2000E+08 
.2000E+08 
. 9000E+07 
.9000E+05 
,4700E+03 
.7000E+01 
.3500E+01 
.6000E+00 
.OOOOE-02 
.lOOOE-03 


.  OOOOE+00 
. OOOOE+00 
. OOOOE+00 
.OOOOE+00 
. OOOOE+00 

.  OOOOE+00 
. OOOOE+00 
.3600E-01 
.3900E+00 
.8500E+00 
.2200E+06 
.5400E+07 
.1800E+07 
.4100E+06 
. 1400E+06 
. 0800E+05 
.3700E+05 
.1300E+04 
.  0200E+03 
.0300E+02 


6.7783E+11 

6.1511E+11 

2.0083E+12 

3.5135E+12 

4.8943E+12 

1.5554E+12 

2.6397E+11 

2.5500E+10 

3.1000E+09 

1.6000E+08 

4.7000E+08 

2.1000E+08 

9.5000E+06 

6.5000E+04 

8.4000E+02 

6.4000E+01 

9.9000E+00 

6.0000E-01 

1.3000E-02 

1.4000E-03 


O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

1.8300E+00 

6.2800E+00 

5.2600E+01 

6.0300E+06 

5.9500E+07 

1.6400E+07 

5.4400E+06 

1.8200E+06 

7.0300E+05 

2.9200E+05 

3.4500E+04 

1.0500E+03 

5.8100E+01 


6.2743E+11 

6.5268E+11 

2.1330E+12 

4.0151E+12 

4.7682E+12 

1.1964E+12 

1.6998E+11 

1.6100E+10 

1.8000E+09 

2.3000E+08 

4.9000E+08 

1.2000E+08 

4.6000E+06 

2.2000E+04 

4.3000E+02 

4.1000E+01 

7.3000E+00 

2.4000E-01 

8.0000E-03 

9.7000E-04 


O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

2.7200E+00 

7.1800E+00 

2.3200E+03 

9.0900E+06 

4.8400E+07 

1.2600E+07 

4.4600E+06 

1.5100E+06 

5.9800E+05 

2.4700E+05 

1.7100E+04 

6.1000E+02 

3.1900E+01 


5.7714E+11 

8.9104E+11 

2.3837E+12 

4.3909E+12 

4.5183E+12 

8.7991E+11 

1.0635E+11 

1.1200E+10 

8.7000E+08 

3.0000E+08 

4.7000E+08 

6.7000E+07 

1.6000E+06 

7.8000E+03 

2.6000E+02 

2.8000E+01 

5.6000E+00 

9.2000E-02 

5.0000E-03 

6.5000E-04 


0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 

0. OOOOE+00 
O.OOOOE+00 
3.6100E+00 
8. 0700E+00 
3.1800E+04 
2.7900E+07 
3.7800E+07 
9.7300E+06 
3.4800E+06 
1.2000E+06 
4.9300E+05 
2.0200E+05 
8.0000E+03 
3.1500E+02 
1.7800E+01 
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OH  DENSITIES 


1.1211E+06 

6.7408E+05 

4.0257E+05 

2.7338E+05 

3.9938E+05 

1.8175E+06 

4.4811E+06 

2.3684E+07 

1.4400E+07 

1.1310E+07 

1.2390E+07 

4.3300E+06 

8.2060E+04 

5.6600E+02 

4.0300E+01 

1.0300E+01 

3.9800E+00 

1.9140E+00 

1.0580E+00 


1.0177E+06 

6.0412E+05 

3.6427E+05 

2.8562E+05 

5.3550E+05 

7.5358E+06 

2.3585E+07 

1.3200E+07 

1.1830E+07 

1.1070E+07 

2.4510E+06 

3.0790E+04 

2.6200E+02 

3.0000E+01 

8.2500E+00 

3.4000E+00 

1.6840E+00 

6.4400E-01 


1.4440E-01  1.0780E-01 
3.8000E-02  3.0200E-02 
1.2820E-02 
END 

N20  DENSITIES 


8.1536E+12 
4.9024E+12 
2.7346E+12 
1.1923E+12 
4.3729E+11 
1.4640E+11 
5.4233E+10 
3.7503E+09 
1.0150E+08 
1.3270E+07 
1.9797E+06 
2.7039E+05 
3 .3596E+04 
3 .9510E+03 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
END 


7.4016E+12 

4.3936E+12 

2.3829E+12 

9.9602E+11 

3.4556E+11 

3.3234E+10 

1.8938E+09 

6.6625E+07 

9.0539E+06 

1.3370E+06 

1.8002E+05 

2.1878E+04 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 


9.2136E+05 

5.4155E+05 

3.2056E+05 

3.0784E+05 

6.8308E+05 

1.1855E+07 

2.1926E+07 

1.1900E+07 

1.2380E+07 

9.8900E+06 

1.3870E+06 

1.1550E+04 

1.4200E+02 

2.2500E+01 

6.7200E+00 

2.9000E+00 

1.4900E+00 

4.1600E-01 

8.1000E-02 

2.4200E-02 


6.7008E+12 

3.9296E+12 

2.0083E+12 

8.2377E+11 

2.7524E+11 

2.0664E+10 
9.3174E+08 
4.3731E+07 
6.1775E+06 
9.0296E+05 
1.1986E+05 
1.4247E+04 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 


8.3204E+05 

4.8683E+05 

2.8784E+05 

3.2890E+05 

8.6830E+05 

1.6972E+07 
1.9200E+07 
1.1600E+07 
1.2610E+07 
8.0150E+06 
6.2760E+05 
4.2160E+03 
8. 6800E+01 
1.7300E+01 
5.5900E+00 
2.5200E+00 
1.3220E+00 
2.8200E-01 
6.2400E-02 
1.9420E-02 


6.0512E+12 
3 .5008E+12 
1.6904E+12 
6.7576E+11 
2.2502E+11 

1.2450E+10 
4.6029E+08 
2.9112E+07 
4.2224E+06 
6.0638E+05 
7.8983E+04 
9.2857E+03 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 


7.4976E+05 

4.4319E+05 

2.6775E+05 

3.5473E+05 

1.1327E+06 

2.1549E+07 

1.6377E+07 

1.1400E+07 

1.2500E+07 

5.8910E+06 

2.2690E+05 

1.4970E+03 

5.7500E+01 

1.3700E+01 

4.7300E+00 

2.1800E+00 

1.1820E+00 

1.9900E-01 

4.8600E-02 

1.5780E-02 


5.4528E+12 
3 .1052E+12 
1.4212E+12 
5.4659E+11 
1.8309E+11 

7.0711E+09 
2.2454E+08 
1.9655E+07 
2.8912E+06 
4.0491E+05 
5.1512E+04 
6.0571E+03 
O.OOOOE+00 
O.OOOOE+00 
0. OOOOE+00 
0. OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
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CH4  DENSITIES 
4.3316E+13  3. 
2.6044E+13  2. 
1.4494E+13  1. 
6.5003E+12  5. 
2.6330E+12  2. 
8.7955E+11 
3.4991E+11  2. 
4.6852E+10  2. 
4.4450E+09  3. 
9.5910E+08  7. 
2.5670E+08  1. 
5.7230E+07  4. 
9.8740E+06  6. 
1.4150E+06  9. 
2.0270E+05  1. 
1.5280E+04  8. 
7,8400E+02  4. 
5.1390E+01  3. 
3.8780E+00  3. 
2.4640E-05  2. 
2.9920E-10  3. 
4.6620E-15 
END 

N02  DENSITIES 
5.8604E+08  5. 
3.5236E+08  3. 
2.0473E+08  1. 
6.9255E+08  1. 
2.5701E+09  2. 
3.1180E+09 
2.3593E+09  1. 
3.3489E+08  1. 
9.4625E+06  6. 
1.8314E+06  1. 
3.9801E+05  2. 
7.7406E+04  5. 
1.3059E+04  8. 
2.0213E+03  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00 
END 


9321E+13 

3341E+13 

2712E+13 

4769E+12 

1341E+12 

3213E+11 

9945E+10 

1890E+09 

4560E+08 

9330E+08 

1610E+07 

7260E+06 

6670E+05 

2000E+05 

2020E+03 

4800E+02 

0370E+01 

2080E-01 

4830E-06 

2240E-11 


3199E+08 

1579E+08 

9883E+08 

1044E+09 

7720E+09 

9168E+09 

5313E+08 

7078E+06 

3514E+06 

8942E+05 

4940E+04 

9979E+03 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 


3.5598E+13 

2.0864E+13 

1.0785E+13 

4.5969E+12 

1.7070E+12 

1.5833E+11 

1.8799E+10 

2.2830E+09 

5.7630E+08 

1.4380E+08 

3.0060E+07 

4.5700E+06 

6.6220E+05 

7.3320E+04 

4.4730E+03 

2.5800E+02 

1.8030E+01 

2.8280E-02 

2.5480E-07 

3.5020E-12 


4.8162E+08 

2.8244E+08 

2.0440E+08 

1.5362E+09 

2.8987E+09 

1.4748E+09 

6.9743E+07 

4.7551E+06 

9.9725E+05 

2.1045E+05 

3.8994E+04 

6.1997E+03 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 


3.2147E+13 

1.8565E+13 

9.1232E+12 

3.8481E+12 

1.3625E+12 

1.0876E+11 

1.1652E+10 

1.6780E+09 

4.4290E+08 

1.0640E+08 

2.1270E+07 

3.0960E+06 

4.4990E+05 

4.3900E+04 

2.4750E+03 

1.4970E+02 

1.0760E+01 

2.6120E-03 

2.6560E-08 

3.8300E-13 


4.3493E+08 

2.5162E+08 

2.4680E+08 

1.9506E+09 

2.9515E+09 

1.0482E+09 

3.3037E+07 

3.4239E+06 

7.3490E+05 

1.5168E+05 

2.7316E+04 

4.2689E+03 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 


2.8968E+13 

1.6454E+13 

7.7056E+12 

3.2012E+12 

1.0917E+12 

7.3266E+10 

7.1950E+09 

1.2640E+09 

3.3820E+08 

7.8240E+07 

1.4470E+07 

2.0920E+06 

3.0300E+05 

2.5660E+04 

1.3860E+03 

8.7440E+01 

6.4470E+00 

2.5020E-04 

2.8040E-09 

4.2140E-14 


3.9192E+08 

2.2548E+08 

3.5448E+08 

2.2928E+09 

2.9881E+09 

6.5527E+08 

1.6838E+07 

2.5041E+06 

5.4083E+05 

1.0836E+05 

1.8887E+04 

2.9375E+03 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 
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S02  DENSITIES 
7.6440E+09  6. 
1.8078E+09  1. 
5.2300E+08  4. 
2.3288E+08  1. 
5.8983E+07  4. 
1.4590E+07 
5.1322E+06  3. 
l,1302E+06  9. 
7.6042E+05  6. 
3.3094E+05  2. 
7.4434E+04  4. 
5.0966E+03  2. 
1.5985E+02  7. 
4.2566E+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00 
END 

NH3  DENSITIES 
1.2740E+10  1. 
3.1253E+09  2. 
1.7462E+08  8. 
1.8104E+06  7. 
4.4561E+04  3. 
1.0255E+04 
2.4321E+03  1. 
2.4431E+01  6. 
1.5230E-01  1. 
2.3519E-02  1. 
4.4281E~03  3. 
7.8173E-04  5. 
1.2203E-04  8. 
1.7597E-05  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00  0. 
O.OOOOE+00 
END 


3376E+09 

3332E+09 

3940E+08 

9907E+08 

2052E+07 

3881E+06 

8978E+05 

6413E+05 

5532E+05 

7032E+04 

6043E+03 

7542E+01 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 


1565E+10 

0046E+09 

2720E+07 

3048E+05 

0240E+04 

1260E+03 

9331E+00 

0257E-01 

6810E-02 

1532E-03 

4451E-04 

2951E-05 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 

OOOOE+00 


4 .9418E+09 
1.0192E+09 
3.6338E+08 
1.5895E+08 
3.0598E+07 

2.3993E+06 
8.9706E+05 
5.8004E+05 
1.9699E+05 
2.9717E+04 
1.3308E+03 
3.7616E+01 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 


9.6952E+09 

1.2133E+09 

4.0881E+07 

3.2560E+05 

2.3082E+04 

4.9054E+02 
2.1539E+00 
6.9077E-02 
1.2015E-02 
2.2454E-03 
3.7927E-04 
5.6388E-05 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
0. OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 


3.5929E+09 

7.8877E+08 

3.1002E+08 

1.2093E+08 

2.3681E+07 

1.8044E+06 
8.3851E+05 
4.9113E+05 
1.4616E+05 
1.7382E+04 
6.6589E+02 
1.8215E+01 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 


7.1858E+09 

7.0891E+08 

1.7304E+07 

1.6951E+05 

1.8190E+04 

2. 1244E+02 
7.6435E-01 
4.7542E-02 
8.6038E-03 
1.5873E-03 
2.6159E-04 
3.8281E-05 
O.OOOOE+00 
0. OOOOE+00 
0. OOOOE+00 
0. OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 
O.OOOOE+00 


2.4878E+09 

6.3757E+08 

2.6728E+08 

8.5871E+07 

1.8553E+07 

1.4159E+06 

7.9891E+05 

4.0316E+05 

1.0430E+05 

9.4122E+03 

3.2625E+02 

8.8054E+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 


4.9075E+09 

3.6641E+08 

5.2603E+06 

8.5871E+04 

1.4062E+04 

8.4150E+01 

3.1623E-01 

3.3439E-02 

6.1724E-03 

1.1139E-03 

1.7866E-04 

2.5955E-05 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 
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HN03  DENSITIES 

1.2740E+09  1.3785E+09  1.4511E+09 
1.4937E+09  1.5240E+09  1.5473E+09 
1.4967E+09  1.5330E+09  1.5638E+09 
1.8306E+09  2.5515E+09  3.8776E+09 
7.7658E+09  7.7805E+09  7.3273E+09 
4.6771E+09 

1.4324E+09  7.6476E+08  4.0042E+08 
4.4292E+07  1.8252E+07  7.6335E+06 
1.1855E+06  8.5621E+05  6.1840E+05 
2.4676E+05  1.8381E+05  1.3692E+05 
5.6342E+04  4.1378E+04  3.0389E+04 
1.1534E+04  8.2537E+03  5.9062E+03 
2.0266E+03  1.4063E+03  9.7583E+02 
3.2460E+02  O.OOOOE+00  O.OOOOE+00 
O.OOOOE+00  O.OOOOE+00  O.OOOOE+00 
O.OOOOE+00  O.OOOOE+00  O.OOOOE+00 
O.OOOOE+00  O.OOOOE+00  O.OOOOE+00 
O.OOOOE+00  O.OOOOE+00  O.OOOOE+00 
O.OOOOE+00  O.OOOOE+00  O.OOOOE+00 
O.OOOOE+00  O.OOOOE+00  O.OOOOE+00 
O.OOOOE+00  O.OOOOE+00  O.OOOOE+00 
O.OOOOE+00 
END 


1.4958E+09 

1.5207E+09 

1.5307E+09 

5.3383E+09 

6.5666E+09 

2.0314E+08 

3.6096E+06 

4.5180E+05 

1.0190E+05 

2.2128E+04 

4.1712E+03 

6.7653E+02 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 


1.5114E+09 

1.4870E+09 

1.5781E+09 

6.8567E+09 

5.7028E+09 

9.8207E+07 

1.9782E+06 

3.3389E+05 

7.5771E+04 

1.5976E+04 

2.9075E+03 

4.6861E+02 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 

O.OOOOE+00 
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APPENDIX  F 

SAMM  "TSTl.OUT"  OUTPUT  FILE 
(EXCERPTS  FROM  TEST  CASE  1) 
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APPENDIX  F 


SAMM  ”TST1.0UT“  OUTPUT  FILE 
(EXCERPTS  FROM  TEST  CASE  1) 


AAAAAA  RRRRRR  CCCCCC 

AA  AA  RR  RR  CC 
AA  AA  RR  RR  CC 
SSSSS  HHHHHHHH  AAAAAAAA  RRRRRRR  CC 
SS  HH  HH  AA  AA  RR  RR  CC 
SS  HH  HH  AA  AA  RR  RR  CC 
SSSSSS  HH  HH  AA  AA  RR  RR  CCCCCC 


STRATEGIC  HIGH -ALTITUDE  RADIANCE  CODE 


VERSION  3.0 


SSSSSS  HH  HH 
SS  HH  HH 

SS  HH  HH 


********** 

1 

CALCULATION  SUMMARY 

NUMBER  OF  REGIONS: 

ENVIRONMENT (S)  FOR  REGION  1: 

1  -  AMBIENT 

SAVING  POPULATION  FILE: 
SPECIES- ISOTOPE  INPUT  FILES: 

NO 


ENVIRONMENT(S)  FOR  REGION  2: 

2  -  AURORAL 

SAVING  POPULATION  FILE: 
SPECIES- ISOTOPE  INPUT  FILES: 

NO 


NO+ 


CASE  1:  NO  &  NO+  ONLY,  AURORAL  REGION 


2 


POP1.180 

1  NO.LNK 
NO.STA 
NO.BND 


POPIA.ISO 

1  ANO.LNK 
ANO.STA 

1  ANOP.LNK 
ANOP.STA 


********** 
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RADIANCE  CALCULATION 

SPECIES- ISOTOPE  INCLUDED:  NO  -1 

NO+  -1 

MINIMUM  FREQUENCY:  1500.0  CM-1 

MAXIMUM  FREQUENCY:  4000.0  CM-1 

SPECTRAL  RESOLUTION:  1.0  CM-1 

SPECTRAL  STEP  SIZE:  1.0  CM-1 


SUN  LOCATION 
SOLAR  LONGITUDE: 
SOLAR  LATITUDE: 
DAY  OF  YEAR: 


180.0  DEG 
-23.0  DEG 
2 


LINE-OF-SIGHT  GEOMETRY 
LOS  TYPE: 

GEOGRAPHIC  POLE  COORDINATE  SYSTEM 
SPHERICAL  EARTH  ASSUMED 
LONG  PATH  SOURCE  RANGE: 

TANGENT  POINT  LOCATION 
TANGENT  POINT  LOCAL  LOS  AZIMUTH: 
TANGENT  ALTITUDE: 

TANGENT  LONGITUDE: 

TANGENT  LATITUDE: 

TANGENT  SOLAR  EARTH  CENTER  ANGLE: 
TANGENT  SOLAR  AZIMUTH: 

OBSERVER  POINT  LOCATION 
OBSERVER  LOCAL  LOS  ZENITH  ANGLE: 
OBSERVER  LOCAL  LOS  AZIMUTH  ANGLE: 
OBSERVER-EARTH-SOURCE  ANGLE: 
OBSERVER  ALTITUDE: 

OBSERVER  LONGITUDE: 

OBSERVER  LATITUDE: 

OBSERVER  SOLAR  EARTH  CENTER  ANGLE: 
OBSERVER  SOLAR  AZIMUTH: 

SOURCE  POINT  LOCATION 
SOURCE  ALTITUDE: 

SOURCE  LONGITUDE: 

SOURCE  LATITUDE: 

SOURCE  SOLAR  EARTH  CENTER  ANGLE: 
SOURCE  SOLAR  AZIMUTH: 


LIMB  VIEWING  PATH 


3242.5  KM 

-90.0  DEG 
100.0  KM 
.0  DEG 
65.0  DEG 
138.0  DEG 
.0  DEG 

104.1  DEG 
-62.5  DEG 

28.1  DEG 
300.0  KM 
30.7  DEG 
61.5  DEG 
136-1  DEG 
-20.5  DEG 

300.0  KM 
329.3  DEG 

61.5  DEG 

136.1  DEG 

20.5  DEG 
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1 

ANBIENT  ATMOSPHERIC  REGION  NUMBER  1.  PROFILE  1. 


AMBIENT  PARAMETERS 

ATMOSPHERE  FILE:  MIDLAT.NIG 

NUMBER  OF  LAYERS:  75 

LOWER  BOUNDARY:  30.0  KM 

UPPER  BOUNDARY:  300.0  KM 

EARTHSHINE  EXCITATION:  Y 

SOLAR  ZENITH  ANGLE:  138.0 

RADIATING  SPECIES- ISOTOPE:  NO  -1 


UN  160 

RADIATIVE  PROPERTIES 

FOR  REGION  1. 

STATE 

ENERGY(CM-l) 

DEGENERACY 

N0(0) 

.000 

1. 

NO(1) 

1876-077 

1. 

NO(2) 

3724.067 

1. 

TRANSITION 

FREQUENCY<CH-1) 

ESHINE  T(K) 

RADIANCE 

NOCI) 

-NO(0) 

1876.077 

240.0 

Y 

NO(2) 

-NO(0) 

3724.067 

230.0 

Y 

NO(2) 

-NO(I) 

1847.990 

240.0 

Y 

96- 


TRANSITIOM 


NOd) 


N0(2) 


NO(2) 


-NO(0) 


-MO(0) 


-NOCD 


NO.  OF  LINES  AVERAGE  STRENGTH 

(CM-1/MOLEC-CM-2) 


T(K)/  200. 

250. 

300. 

500. 

1000. 

33. 

.110E-18 

.999E-19 

.912E-19 

.661E«19 

.362E-19 

od 

(M 

.379E-19 

.427E-19 

.455E-19 

.461E-19 

.329E-19 

19. 

.110E-19 

.163E-19 

.212E-19 

.328E-19 

.322E-19 

15. 

.355E-20 

.618E-20 

.928E-20 

.197E-19 

.249E-19 

17. 

.118E-20 

.250E-20 

.441E-20 

.132E-19 

.215E-19 

15. 

.344E-21 

.938E-21 

.197E-20 

.841E-20 

.180E-19 

11. 

.109E-21 

.357E’21 

.870E-21 

.512E-20 

.140E-19 

12. 

.365E-22 

.160E-21 

.464E-21 

.372E-20 

.126E-19 

11. 

.111E>22 

.657E-22 

.228E-21 

.260E-20 

.115E-19 

10. 

.346E-23 

.250E-22 

.101E-21 

.158E-20 

.384E-20 

10. 

.107E-23 

.994E-23 

.473E-22 

.102E-20 

.728E-20 

8. 

.345E-24 

.451E-23 

.261E-22 

.806E-21 

.738E-20 

9. 

.116E-24 

.152E-23 

.962E-23 

.386E-21 

.442E-20 

8. 

.353E-25 

.660E-24 

.510E-23 

.290E-21 

.424E-20 

17. 

.729E-26 

.186E-24 

.175E-23 

.152E-21 

.312E-20 

33. 

.174E-20 

.159E-20 

.145E-20 

.106E-20 

.614E-21 

cd 

.605E-21 

.680E-21 

.724E-21 

.737E-21 

.560E-21 

19. 

.174E-21 

.259E-21 

.337E-21 

.523E-21 

.546E'21 

15. 

.566E-22 

.985E-22 

.148E-21 

.316E-21 

.424E-21 

18. 

.182E-22 

.393E-22 

.697E-22 

.212E-21 

.372E-21 

14. 

.523E-23 

.139E-22 

.291E-22 

.126E-21 

.292E-21 

12. 

.167E-23 

,564E-23 

,140E-22 

.846E-22 

.249E-21 

11. 

.552E-24 

.234E-23 

.674E-23 

.550E-22 

.202E-21 

12. 

.170E-24 

.103E-23 

.361E-23 

.421E-22 

.200E-21 

10. 

.489E-25 

.349E-24 

.143E-23 

.234E-22 

.145E-21 

10. 

.150E-25 

.139E-24 

.673E-24 

.153E-22 

.121E-21 

7. 

.499E-26 

.636E-25 

.371E-24 

.118E-22 

.118E-21 

7. 

.188E-26 

.210E-25 

.124E-24 

.473E-23 

.573E-22 

3. 

.538E-27 

.364E-26 

.127E-25 

.138E-24 

.617E-24 

6. 

.114E-27 

.110E-26 

.483E-26 

-830E-25 

.522E-24 

33. 

.212E-18 

.193E-18 

.176E-18 

.127E-18 

.695E-19 

28. 

.739E-19 

.830E-19 

.883E-19 

.892E-19 

.633E‘19 

20. 

.211E-19 

.315E-19 

.413E-19 

.639E-19 

.627E-19 

16. 

.637E-20 

.113E-19 

.173E-19 

.385E-19 

.502E-19 

17. 

-208E-20 

.435E-20 

,768E-20 

.236E-19 

.396E-19 

14. 

.609E-21 

.161E-20 

.337E-20 

.149E-19 

.327E-19 

12. 

.195E-21 

.650E-21 

.162E-20 

.100E-19 

.282E-19 

11. 

.651E-22 

.271E-21 

.777E-21 

.638E-20 

.223E-19 

11. 

.212E-22 

.123E-21 

.428E-21 

.490E-20 

.216E-19 

10. 

.654E-23 

.463E-22 

.187E-21 

.296E-20 

.167E'19 

10. 

.204E-23 

.187E‘22 

.892E-22 

.195E-20 

.140E-19 

9. 

.620E’24 

.765E-23 

.439E-22 

.136E-20 

.125E-19 

8. 

.209E-24 

.304E-23 

.199E-22 

.836E-21 

.982E-20 

8. 

.695E-25 

,125E-23 

.957E-23 

.540E-21 

.785E-20 

16. 

.151E-25 

.367E-24 

.342E-23 

.293E-21 

.592E-20 
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UN  160  RADIATIVE  EXCITATION  SUMMARY  PROFILE  1.  REGION  1. 
NEMESIS  OUTPUT  FOR  N0(1)  -NO(0) 


EARTHSHINE  FLUX(PH0T0NS/SEC/CM2/CM-1):  .865E+13 
EINSTEIN  A  C0EFFICIENT(1/SEC):  .132E+02 
SUM  OF  EINSTEIN  A  C0EFFICIENTS(1/SEC):  .132E+02 
TOTAL  NUMBER  OF  PHOTONS:  10000 
MAXIMUM  ORDER  OF  SCATTERING:  200 


ALT(ICM) 

POPULAT I ONS(MOLEC/CH3) 

PROBABILITIES 

QUENCHING 

EXCITATION  RATESC 1/SEC) 

LOWER  STATE 

UPPER 

STATE 

RE-EMISSION 

ESCAPE 

RATE(1/SEC) 

EARTH 

SUN 

ATMOSPHERE 

INITIAL 

FINAL 

.310E+02 

.102E+10 

.731E+04 

,731E+04 

.731E-02 

.100E+01 

.179E+04 

.859E-04 

.OOOE+OO 

.OOOE+OO 

.330E+02 

.115E+10 

.999E+04 

.999E+04 

.100E-01 

.100E+01 

.130E+04 

.859E-04 

.OOOE+00 

.OOOE+OO 

.350E+02 

.121E+10 

.133E+05 

.133E+05 

.134E-01 

.100E+01 

.968E+03 

.858E-04 

.OOOE+OO 

.OOOE+OO 

.370E+02 

.116E+10 

.163E+05 

.163E+05 

.178E-01 

.100E+01 

.726E+03 

.857E-04 

.OOOE+OO 

.OOOE+OO 

.275E+03 

,117E+05 

.312E+01 

.312E+01 

.996E+00 

.100E+01 

.585E-01 

.781E-04 

.OOOE+OO 

.OOOE+OO 

.285E+03 

.768E+04 

,174E+01 

.174E+01 

.996E+00 

.100E+01 

.486E-01 

.780E-04 

.OOOE+OO 

.OOOE+OO 

.295E+03 

.504E+04 

.975E+00 

.975E+00 

.997E+00 

.100E+01 

.405E-01 

.779E-04 

.OOOE+OO 

.OOOE+OO 
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UN  160  RADIATIVE  EXCITATION  SUMMARY  PROFILE  1.  REGION  1. 

NEMESIS  OUTPUT  FOR  NO(2)  -MO(0) 


EARTHSHINE  FLUX(PHOTONS/SEC/CM2/CH-1):  .199E+09 
EINSTEIN  A  COEFFICIENT(1/SEC):  .836E+00 
SIW  OF  EINSTEIN  A  COEFFICIENTS(1/SEC):  .256E+02 
TOTAL  HUMBER  OF  PHOTONS:  10000 
MAXIMUM  ORDER  OF  SCATTERING:  200 


ALT(KM) 

POPULAT I0NS(M0LEC/CM3) 

PROBABILITIES 

QUENCHING 

EXCITATION  RATESC 1/SEC) 

LOWER  STATE 

UPPER 

STATE 

RE-EMISSION 

ESCAPE 

RATE (1 /SEC) 

EARTH 

SUN 

ATMOSPHERE 

INITIAL 

FINAL 

.310E+02 

.102E+10 

.623E-01 

.623E-01 

.183E-03 

.100E+01 

.453E+04 

.315E-10 

.OOOE+OO 

.OOOE+OO 

.330E+02 

.115E+10 

.102E+00 

.102E+00 

.252E-03 

.100E+01 

.329E+04 

.315E-10 

.OOOE+OO 

.OOOE+OO 

.350E+02 

.121E+10 

.172E+00 

.172E+00 

.337E-03 

.100E+01 

.246E+04 

.315E-10 

.OOOE+OO 

.OOOE+OO 

.370E+02 

.116E+10 

.268E+00 

.268E+00 

.447E-03 

.100E+01 

.184E+04 

.315E-10 

.OOOE+OO 

.OOOE+OO 

.275E+03 

.117E+05 

.325E-01 

.325E-01 

.326E-01 

.100E+01 

.562E-01 

.300E-10 

.OOOE+OO 

.OOOE+OO 

.285E+03 

.768E+04 

.184E-01 

.184E-01 

.326E-01 

.100E+01 

.466E-01 

.300E-10 

.OOOE+OO 

.OOOE+OO 

.295E+03 

.504E+04 

.104E-01 

.104E-01 

.326E-01 

.100E+01 

.388E-01 

.300E-10 

.OOOE+OO 

.OOOE+OO 
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1 


UN  160 


RADIATIVE  EXCITATION  SUMMARY 


PROFILE  1. 


REGION  1. 


NEMESIS  OUTPUT  FOR  N0(2)  -N0(1) 

EARTHSHINE  FLUX(PH0T0NS/SEC/CM2/CM-1):  .993E+13 

EINSTEIN  A  COEFFICIENT! 1/SEC):  .248E+02 

SUM  OF  EINSTEIN  A  C0EFFICIENTSC1/SEC):  .256E+02 

TOTAL  NUMBER  OF  PHOTONS:  10000 

MAXIMUM  ORDER  OF  SCATTERING:  200 

ALT(ICM)  POPULATIONS(MOLEC/CM3)  PROBABILITIES  QUENCHING  EXCITATION  RATESCI/SEC) 


LOWER  STATE 

UPPER 

INITIAL 

STATE 

FINAL 

RE-EMISSION 

.310E+02 

.731E+04 

.626E-01 

-626E-01 

.543E-02 

.330E+02 

,999E+04 

.103E+00 

.103E+00 

.746E-02 

.350E+02 

.133E+05 

.173E+00 

.173E+00 

.9988-02 

.370E+02 

.163E+05 

.269E+00 

.269E+00 

.133E-01 

it  it  -k 

.275E+03 

-312E+01 

.325E-01 

.325E-01 

.965E+00 

.285E+03 

.174E+01 

.184E-01 

.184E-01 

.966E+00 

.295E+03 

,975E+00 

.104E-01 

.104E-01 

.966E+00 

14N  160 

EXCITED 

STATE  NUMBER  DEMSITIES(HOLEC/CH3) 

ALT(KM) 

N0(0) 

NO(l) 

NO(2) 

31.0 

.102E+10 

.731E+04 

.626E-01 

33.0 

.115E+10 

.999E+04 

.103E+00 

35.0 

.121E+10 

.133E+05 

.173E+00 

37.0 

.116E+10 

.163E+05 

.269E+00 

★  *  * 

275.0 

.117E+05 

-312E+01 

.325E-01 

285.0 

.768E+04 

.174E+01 

.184E-01 

295.0 

.504E+04 

.975E+00 

.1O4E-01 

ESCAPE 

RATECI/SEC) 

EARTH 

SUN 

ATMOSPHERE 

.100E+01 

.453E+04 

.191E-03 

-OOOE+00 

.OOOE+OO 

.100E+01 

.329E+04 

.191E-03 

,000E+00 

.OOOE+OO 

.100E+01 

.246E+04 

.191E-03 

.OOOE+OO 

.OOOE+OO 

-100E+01 

.184E+04 

.191E-03 

.OOOE+00 

.OOOE+OO 

.100E+01 

.562E-01 

.175E-03 

.OOOE+OO 

.OOOE+OO 

.100E+01 

.466E-01 

.174E-03 

.OOOE+OO 

.OOOE+OO 

.100E+01 

.388E-01 

.174E-03 

, OOOE+OO 

.OOOE+OO 

PROFILE  1.  REGION  1. 
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14M  160  VIBRATIONAL  TEMPERATURES (K)  PROFILE  1.  REGION  1. 


ALTOCM) 

KINETIC 

NOd) 

NO<2) 

31.0 

227.9 

227.9 

227.9 

33.0 

231.6 

231.5 

231.5 

35.0 

236.5 

236.3 

236.4 

37.0 

241.7 

241.5 

241.5 

*  ★ 

* 

275.0 

960.4 

328.0 

418.9 

285.0 

966.6 

321.7 

414.0 

295.0 

972.9 

315.7 

409.3 

1 

AMBIENT  ATMOSPHERIC  REGION  NUMBER  2.  PROFILE  1. 


AMBIENT  PARAMETERS 

ATMOSPHERE  FILE:  HIDLAT.NIG 

NUMBER  OF  LAYERS:  75 

LOWER  BOUNDARY:  30.0  KM 

UPPER  BOUNDARY:  300.0  KM 

EARTHSHINE  EXCITATION:  Y 

SOLAR  ZENITH  ANGLE:  138.0 

RADIATING  SPECIES-ISOTOPE:  NO  -1 


1 

14N  160  RADIATIVE  PROPERTIES  FOR  REGION  2. 


STATE 

NO(0) 

NOd) 

NO(2) 


EMERGY(CH-I) 

.000 

1876.077 

3724.067 


DEGENERACY 

1. 

1. 

1. 


TRANSITION 
NOCI)  -MO(0) 
NO(2)  -NOCO) 
NO<2)  -NO<1> 


FREQUENCY(C«-1) 

ESHINE  T(IO 

RADIANCE 

1876.077 

240.0 

Y 

3724.067 

230.0 

Y 

1847.990 

240.0 

Y 

100- 


1 


14M  160  EXCITED  STATE  NUMBER  DENSITIES(M0LEC/CM3)  PROFILE  U 


ALT(KM) 

N0(0} 

NO(1) 

NO(2) 

31.0 

.102E+10 

.731E+04 

.626E-01 

33.0 

.115E+10 

.999E+04 

.103E+00 

35.0 

.121E+10 

.133E+05 

.173E+00 

37.0 

.116E+10 

.163E+05 

.269E+00 

*  * 

* 

275.0 

.117E+05 

.312E+01 

.325E-01 

285.0 

.768E+04 

.174E+01 

.184E-01 

295.0 

.504E+04 

.975E+00 

.104E-01 

1 

UN  160  VIBRATIONAL  TEMPERATURES(K)  PROFILE  1.  REGION  2 


ALT(KM) 

KINETIC 

NO(1) 

NO(2) 

31.0 

227.9 

227.9 

227.9 

33.0 

231.6 

231.5 

231.5 

35.0 

236.5 

236.3 

236.4 

37.0 

241.7 

241.5 

241.5 

*  * 

* 

275.0 

960.4 

328.0 

418.9 

285.0 

966.6 

321.7 

414.0 

295.0 

972.9 

315.7 

409.3 

1 

AURORAL  ATMOSPHERIC  REGION  NUMBER  2.  PROFILE  1. 


AMBIENT  PARAMETERS 
ATMOSPHERE  FILE: 

NUMBER  OF  LAYERS: 

LOWER  BOUNDARY: 

UPPER  BOUNDARY: 

EARTHSHINE  EXCITATION: 
SOLAR  ZENITH  ANGLE: 

AURORAL  PARAMETERS 
MAXWELLIAN  ELECTRON  ENERGY 
CODE -SELECTED  IBC  CLASS: 
TOTAL  ENERGY  FLUX: 
CHARACTERISTIC  ENERGY: 
DURATION  OF  AURORA: 

TIME  OF  OBSERVATION: 

RADIATING  SPECIES- ISOTOPE: 


MIDLAT.NIG 

75 

30.0  KM 
300.0  KM 
Y 

138.0 

SPECTRUM 

III 

100.0  ERGS/CM2/SEC 
5.0  KEV 
100.0  SEC 
100.0  SEC 

NO  -1 
NO+  -1 


REGION  2 


101- 


1 


14N  160 

RADIATIVE  PROPERTIES 

FOR  REGION  2. 

STATE 

ENERGY ( CM- 1) 

DEGENERACY 

NOCO) 

.000 

1- 

N0(1) 

1876.174 

1. 

N0<2) 

3724.170 

1. 

N0(3) 

5544.125 

1. 

N0(4) 

7336.086 

1. 

N0(5) 

9100.091 

1. 

N0(6) 

10836.123 

1. 

N0<7) 

12544.098 

1. 

N0(8} 

14223.999 

1- 

N0(9) 

15875.815 

1- 

NO(10) 

17499.535 

1. 

N0(11) 

19095.146 

1, 

N0(12) 

20662.643 

1- 

TRANSITION 

FREQUENCY(CM-I) 

ESHINE  T(IC) 

RADIANCE 

NOd) 

-NO(0) 

1876.174 

240.0 

Y 

NO(2) 

-NO(0) 

3724.170 

240.0 

Y 

NO(2) 

-NOd) 

1847.996 

240.0 

Y 

NO(3) 

-NOd) 

3667.951 

240.0 

Y 

NO(3) 

-NO(2) 

1819.955 

240.0 

Y 

N0(4) 

-NO<2) 

3611.916 

240.0 

Y 

N0(4} 

-NO(3) 

1791.961 

240.0 

Y 

NO(5) 

-NO(3) 

3555.966 

240.0 

Y 

NO(5) 

-NO(4) 

1764.005 

240.0 

Y 

NO(6} 

-NO(4) 

3500.037 

240.0 

Y 

N0(6) 

-NO(5) 

1736.032 

240.0 

Y 

N0{7) 

-NO(5) 

3444.007 

240.0 

Y 

NO(7) 

-NO(6) 

1707.975 

240.0 

Y 

N0(8) 

-NO(6) 

3387.876 

240.0 

Y 

NO(8) 

-N0(7) 

1679.901 

240.0 

Y 

N0(9) 

-N0(7) 

3331.718 

240.0 

Y 

N0(9) 

-N0(8) 

1651.816 

240.0 

Y 

NOdO) 

-NO(8) 

3275.536 

240.0 

Y 

NOdO) 

-NO(9) 

1623.720 

240.0 

Y 

NOdl) 

-NO(9) 

3219.331 

240.0 

Y 

NOdI) 

-NOdO) 

1595.611 

240-0 

Y 

NOd2) 

-NOdO) 

3163.107 

240.0 

Y 

NOd2) 

-NOdl) 

1567.496 

240.0 

Y 

-102- 
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SUHMARY  OF  AURORAL  ENHANCEMENT  PROFILE  1.  REGION  2. 
•  AURORALLY  ENHANCED  NUMBER  DENSITIES(MOLEC/CM3) 


ALTCKM) 

T(SEC) 

N2 

02 

0 

NO 

N2+ 

02+ 

0+ 

M0+ 

CH4 

EP 

ES(1) 

ES(2) 

ES(3) 

ES(4) 

ES(5) 

ES(6) 

ES(7) 

ES(8) 

ES(9) 

ES(10) 

ES(11) 

ESC12) 

ES(13) 

ES(14) 

N2(1) 

N2(2) 

N2(3) 

M2(4) 

N2<5) 

N2(a) 

N2(A) 

N2(BU) 

N2(C) 

N2(R) 

02(1) 

02Ca) 

02(b) 

02(A) 

02(B) 

02(R) 

0(1D) 

OdS) 

OdS) 

NC2D) 

N(4S) 

N0(0) 

N0(1) 

N0(2) 

NO(3) 

NO(4) 

N0(5) 

N0(6) 

N0(7) 

N0(8) 

N0(9) 

NOCIO) 

NO(11) 

N0(12) 

81.0 

25.0 

.260E+15 

.697E+14 

.152E+11 

.106E+08 

.610E-03 

.101E+03 

.384E-05 

-178E-04 

.245E+02 

.494E+08 

.100E+01 

-125E+03 

.806E-03 

.201E-03 

.154E-05 

.166E-06 

.117E-06 

.409E-06 

.199E-05 

.565E-05 

.117E-05 

.345E-06 

.101E-06 

.762E-07 

.610E-07 

.581E+05 

.391E+00 

.104E+00 

.233E-01 

,655E-02 

.175E+02 

.474E-02 

.547E+02 

.146E+02 

.633E+02 

.453E+03 

.586E+02 

.419E+01 

.276E+02 

.937E+01 

.169E+02 

.425E-03 

.187E+01 

.125E-02 

.832E-02 

.846E+02 

.106E+08 

.587E+02 

.864E-01 

.496E-01 

.294E-01 

.172E-01 

.109E-01 

.6488-02 

.381E-02 

.195E-02 

,954E-03 

-428E-03 

.138E-03 

83.0 

70.0 

.188E+15 

.505E+14 

.312E+11 

.113E+08 

.114E-01 

.371E+04 

.740E-04 

.340E-03 

.952E+03 

.358E+08 

.100E+01 

.466E+04 

.154E-01 

.384E-02 

.294E-04 

.316E-05 

.223E-05 

.782E-05 

.380E-04 

.108E-03 

.224E-04 

.658E-05 

.193E-05 

.145E-05 

.116E‘05 

.177E+07 

.805E+01 

.212E+01 

.456E+00 

.128E+00 

.678E+03 

.903E-01 

.212E+04 

.565E+03 

.2458+04 

.173E+05 

.227E+04 

.162E+03 

.107E+04 

.363E+03 

.6558+03 

.889E-02 

.731E+02 

.136E+00 

.167E+00 

.330E+04 

.113E+08 

.627E+02 

.1288+01 

.747E+00 

.453E+00 

.273E+00 

.174E+00 

.105E+00 

.623E-01 

.320E-01 

.158E-01 

.715E-02 

.233E-02 

*  »  * 


149.0 

100.0 

-333E+11 

.2958+10 

.185E+11 

.4698+07 

.9158+04 

.242E+06 

.1158+04 

.277E+04 

.120E+06 

.516E+01 

.1008+01 

.2768+06 

.8408+05 

.1518+05 

.843E+02 

.981E+01 

.712E+01 

.2258+02 

.7628+02 

.134E+03 

.514E+02 

.171E+02 

.505E+01 

.3998+01 

.326E+01 

.275E+08 

.444E+07 

.150E+07 

.279E+06 

.842E+05 

.4408+06 

.310E+05 

.1348+07 

.3728+06 

.170E+07 

.696E+07 

.634E+06 

.225E+05 

.1478+06 

.8048+05 

.150E+06 

.761E+05 

.452E+06 

.309E+06 

.711E+06 

.5758+07 

.6278+07 

.856E+04 

.696E+03 

.400E+03 

.260E+03 

.1748+03 

.1128+03 

.7218+02 

.4428+02 

.233E+02 

.118E+02 

.5668+01 

.1998+01 

155.0 

100-0 

.245E+11 

.211E+10 

.1518+11 

.3298+07 

.8828+04 

.2248+06 

.129E+04 

.297E+04 

-105E+06 

.2108+01 

.1008+01 

.2378+06 

.8948+05 

.160E+05 

.890E+02 

.104E+02 

.7538+01 

.2358+02 

.7758+02 

.1328+03 

.528E+02 

.178E+02 

.526E+01 

.4178+01 

.3418+01 

.2018+08 

.361E+07 

.128E+07 

.249E+06 

.789E+05 

.3388+06 

,2938+05 

.1028+07 

.2868+06 

.131E+07 

.522E+07 

.474E+06 

.1628+05 

.106E+06 

.5998+05 

.1125+06 

.806E+05 

.351E+06 

-263E+06 

.6858+06 

.4418+07 

.4358+07 

.627E+04 

.501E+03 

.285E+03 

.185E+03 

.1238+03 

.7948+02 

.5128+02 

.3138+02 

.166E+02 

.834E+01 

.401E+01 

.1418+01 
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14N  160  EXCITED  STATE  NUMBER  DENSITIES(H0LEC/CM3) 


ALT(KH) 

NO(0) 

N0(1) 

M0(2) 

NO(7) 

N0(8) 

N0(9) 

31.0 

,102E+10 

-731E+04 

.626E-01 

.OOOE+00 

.OOOE+OO 

.OOOE+OO 

33.0 

.115E+10 

.999E+04 

.103E+00 

.OOOE+00 

.OOOE+OO 

.OOOE+OO 

35.0 

.121E+10 

.133E+05 

.173E+00 

.OOOE+00 

.OOOE+OO 

.OOOE+OO 

37.0 

.116E+10 

.163E+05 

.269E+00 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

*  * 

* 

275.0 

,117E+05 

.312E+01 

.325E-01 

, OOOE+OO 

.OOOE+OO 

.OOOE+OO 

285.0 

.768E+04 

.174E+01 

.184E-01 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

295-0 

.504E+04 

.975E+00 

.104E-01 

, OOOE+OO 

.OOOE+OO 

.OOOE+OO 

PROFILE  1.  REGION  2. 


N0(3) 

N0(4) 

N0(5) 

N0(6) 

N0(10) 

N0(1l) 

N0(12) 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

, OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

OOOE+OO 

.OOOE+OO 

.OOOE+OO 

OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

OOOE+OO 

.OOOE+OO 

.OOOE+OO 

OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

OOOE+OO 

.OOOE+OO 

.OOOE+OO 

14N  160 

VIBRATIONAL 

TEMPERATURES(K) 

PROFILE  1. 

REGION  2. 

ALT(KH) 

KINETIC 

NOCD 

N0<2) 

N0(3) 

N0(4) 

N0(5) 

N0(6) 

N0(7) 

N0(8) 

N0<9) 

NO(10) 

N0(11) 

N0(12) 

31.0 

227.9 

227.9 

227.9 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

33.0 

231.6 

231.6 

231.6 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

35.0 

236.5 

236.4 

236.4 

.0 

.0 

.0 

-0 

.0 

.0 

.0 

.0 

.0 

.0 

37.0 

241.7 

241.5 

241.5 

.0 

.0 

.0 

.0 

,0 

.0 

.0 

.0 

.0 

.0 

*  * 

★ 

275.0 

960.4 

328.0 

418.9 

.0 

.0 

-0 

.0 

.0 

.0 

.0 

.0 

.0 

,0 

285.0 

966.6 

321.7 

414.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

295.0 

972.9 

315.7 

409.3 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

-104- 


1 


UN  160  1- 

RADIATIVE  PROPERTIES 

FOR  REGION  2. 

STATE 

ENERGYCCM-l) 

DEGENERACY 

N0+(0) 

,000 

1. 

NO+d) 

2344.160 

1. 

N0+(2> 

4655.668 

1. 

NCI+(3) 

6934.433 

1. 

N0+(4) 

9180-356 

1. 

N0+(5) 

11393.349 

1. 

N0+<6) 

13573.319 

1. 

NO(7) 

15720.170 

1. 

N0+<8) 

17833.813 

1. 

N0+(9) 

19914.141 

1- 

NO+(10) 

21961.072 

1. 

N0*{11) 

23974.510 

1. 

NCH-(12) 

25954.361 

1. 

N0+(13) 

27900-529 

1, 

TRANSITION 

FREQUENCY CC«-1) 

ESHINE  T(K) 

RADIANCE 

NOf(1) 

-NO+(0) 

2344.160 

240.0 

Y 

NO+(2) 

-NO+(1) 

2311-508 

240.0 

Y 

NO+(3) 

-NCH-(2) 

2278.765 

240.0 

Y 

N0+(4) 

-NO+(3) 

2245.924 

240.0 

Y 

NCH-(5) 

-NO+<4) 

2212.992 

240.0 

Y 

N0+(6) 

-NO+(5) 

2179.971 

240.0 

Y 

N(H(7) 

-NO+<6) 

2146.851 

240.0 

Y 

N0+(8) 

-NO+<7) 

2113.643 

240.0 

Y 

NCH-(9) 

-NO+(8) 

2080.328 

240.0 

Y 

NCM-<10) 

-NO+(9) 

2046.932 

240.0 

Y 

NO+(11) 

-NCH-<10> 

2013.438 

240.0 

Y 

NO+(12) 

-NO+<11) 

1979.852 

240.0 

Y 

NO+(13) 

-NO+<12) 

1946.168 

240.0 

Y 
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SUMMARY  OF  AURORAL 

ENHANCEMEMT 

PROFILE  1. 

REGION  2. 

AURORALLY  ENHANCED  NUMBER  DENSITIES(M0LEC/CM3) 

ALT(KM)  T(SEC) 

H2 

02 

0 

N+ 

N0+ 

CH4 

ES(4) 

ES<5) 

ES(6) 

ES(11) 

ES<12) 

ES(13) 

N2(4) 

N2(5) 

N2(a) 

02(1) 

02(a) 

02(b) 

0(1S) 

0(LS) 

N(2D) 

NO+(3) 

N0+(4) 

N0+(5) 

NO+(10) 

N0+(11) 

N0+(12) 

81.0  5.0 

.260E+15 

.697E+14 

.152E+11 

.178E-04 

.OOOE+00 

.494E+08 

.154E-05 

-166E-06 

.117E-06 

.345E-06 

.101E-06 

.762E-07 

-230E-01 

.652E-02 

.350E+01 

.906E+02 

.l17E-»*02 

.838E+00 

.197E-02 

.249E-03 

.840E-02 

.174E-03 

,158E-03 

.138E-03 

.437E-04 

-403E-04 

.297E-04 

83.0  5.0 

.188E+15 

.505E+14 

.312E+11 

,340E-03 

.OOOE+00 

.358E+08 

.294E-04 

.316E-05 

.223E*05 

,658E-05 

.193E-05 

.145E-05 

.449E+00 

.127E+00 

.484E+02 

.122E+04 

.162E+03 

.116E+02 

.770E-01 

.975E-02 

.162E+00 

.331E-02 

.299E-02 

.261E-02 

.825E-03 

.760E-03 

.561E-03 

*  *  * 

149.0  15.0 

.333E+11 

,295E+10 

.185E+11 

.275E+04 

.OOOE+00 

.516E+01 

.843E+02 

,981E+01 

.712E+01 

.171E+02 

.505E+01 

.399E+01 

,759E+05 

.336E+05 

.660E+05 

.880E+06 

.898E+05 

.337E+04 

.494E+05 

.464E+05 

.341E+06 

.742E+02 

.539E+02 

.405E+02 

.916E+01 

.827E+01 

.604E+01 

155.0  EO.O 

,245E+11 

.211E+10 

.151E+11 

.294E+04 

.OOOE+00 

.210E+01 

.890E+02 

.104E+02 

.753E+01 

.178E+02 

.526E+01 

.417E+01 

.778E+05 

.340E+05 

.675E+05 

,886E+06 

.899E+05 

.323E+04 

.528E+05 

.526E+05 

.338E+06 

.566E+02 

.412E+02 

.309E+02 

.698E+01 

.630E+01 

.460E+01 

NO 

N2+ 

02+ 

0+ 

EP 

ES(1) 

ES(2) 

ES(3) 

ES(7) 

ESC8) 

ES(9) 

ES(10) 

ES(14) 

N2(1) 

N2(2) 

N2(3) 

N2(A) 

N2(BW) 

N2(C) 

N2(R) 

02(A) 

02(B) 

02(R) 

0(1D) 

N(4S) 

NO+(0) 

N0+(1) 

N0+(2) 

N0+(6) 

N0+(13) 

N0+(7) 

N0+(8) 

N0+(9) 

.106E+08 

.610E-03 

.232E+02 

.263E-03 

.lOOE+01 

.251E+02 

.806E-03 

.2018-03 

.409E-06 

.199E-05 

.565E-05 

.117E-05 

.610E-07 

.111E+05 

.379E+00 

.1028+00 

.473E-02 

.109E+02 

.291E+01 

.127E+02 

.551E+01 

.187E+01 

.338E+01 

.438E-03 

.169E+02 

.186E+01 

-198E-03 

.1878-03 

.114E-03 

.178E-04 

.880E-04 

.573E-04 

.447E-04 

.113E+08 

.114E-01 

.321E+03 

.4988-02 

.100E+01 

,347E+03 

.1548-01 

.3848-02 

.782E-05 

.380E-04 

.1088-03 

.2248-04 

.116E-05 

-355E+05 

-7408+01 

.1998+01 

.902E-01 

.151E+03 

.4038+02 

.175E+03 

.763E+02 

.259E+02 

.4688+02 

.8298-02 

.236E+03 

.260E+02 

.3778-02 

.356E-02 

.216E-02 

.336E-03 

.166E-02 

.1088-02 

.843E-03 

.456E+07 

.912E+04 

.740E+05 

.9108+05 

.100E+01 

.364E+06 

.8288+05 

.1518+05 

,225E+02 

.762E+02 

.134E+03 

.5148+02 

.326E+01 

.291E+07 

.653E+06 

.2818+06 

.2788+05 

.200E+06 

.557E+05 

.2548+06 

.221E+05 

.1218+05 

.2248+05 

.4918+05 

.5158+06 

.285E+06 

.2148+03 

.1118+03 

.300E+02 

.363E+01 

.212E+02 

.1308+02 

.9668+01 

.322E+07 

.875E+04 

.6618+05 

.1028+06 

.100E+01 

.366E+06 

.8838+05 

.1618+05 

.235E+02 

.775E+02 

.1328+03 

.5288+02 

.341E+01 

.3028+07 

.6818+06 

.2928+06 

.267E+05 

.204E+06 

.5718+05 

.2618+06 

.212E+05 

.120E+05 

.2238+05 

.5418+05 

.542E+06 

.290E+06 

.1648+03 

.8498+02 

.229E+02 

.277E+01 

.162E+02 

.990E+01 

.7368+01 
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1 

UN  160  +  EXCITED  STATE  NUMBER  0EMSITIES(M0LEC/CM3) 


ALTCKM) 

NO4-(0) 

NO+(1) 

N0+(2) 

NO+<7) 

NO+(8) 

N0+(9) 

*  * 

★ 

79.0 

.OOOE+00 

.OOOE+OO 

.OOOE+OO 

.OOOE+00 

.OOOE+00 

.OOOE+OO 

81.0 

.186E+01 

.198E-03 

.187E-03 

.880E-04 

.573E-04 

.447E-04 

83.0 

.260E+02 

-377E-02 

.356E-02 

.166E-02 

.108E-02 

.843E-03 

*  * 

★ 

U9.0 

.285E+06 

.2UE+03 

.111E+03 

-212E+02 

-130E+02 

-966E+01 

155.0 

-290E+06 

.164E+03 

.849E+02 

.162E+02 

.990E+01 

.736E+01 

165.0 

.OOOE+00 

.OOOE+OO 

.OOOE+OO 

.OOOE+00 

-OOOE+OO 

.OOOE+OO 

*  *  * 


PROFILE  1.  REGION  2. 


N0+(3> 

N0*(4) 

NCH-(5) 

N0+(6) 

NO+(10) 

NCH-(II) 

N0+(12) 

N0+(13) 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

-174E-03 

.158E-03 

.138E-03 

.1UE-03 

.437E-04 

.403E-04 

.297E-04 

.178E-04 

,331E-02 

.299E-02 

.261E-02 

.216E-02 

.825E-03 

.760E-03 

.561E-03 

.336E-03 

.742E+02 

.539E+02 

.405E+02 

.300E+02 

.916E+01 

.827E+01 

.604E+01 

.363E+01 

.566E+02 

-412E+02 

.309E+02 

.229E+02 

,698E+01 

.630E+01 

.460E+01 

,277£+01 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

1 

UN  160  +  VIBRATIONAL  TEHPERATURES(K)  PROFILE  1. 


ALT(ICM) 

KINETIC 

N0+C1) 

N0+(2) 

N0+(3) 

N0+(8) 

N0+(9) 

NO+C10) 

★  ★ 

* 

79.0 

200.6 

.0 

.0 

.0 

.0 

.0 

.0 

81.0 

196.7 

368.5 

727.7 

1075.5 

2469.7 

2693.2 

2963.9 

83.0 

192.7 

381.6 

753.0 

1112.4 

2544-0 

2772.1 

3050.4 

*  * 

* 

149.0 

627.3 

468.9 

853.4 

1208.8 

2567.0 

2783.9 

3054.2 

155.0 

665.3 

451.0 

823.3 

1168.0 

2494.7 

2707.7 

2971.0 

165-0 

721.9 

.0 

.0 

.0 

.0 

.0 

.0 

*  *  * 


REGION  2. 


N0+(4) 

N0+(5) 

N0+C6) 

N0+(7) 

N0+C11) 

N0+(12) 

N0+<13) 

.0 

.0 

.0 

.0 

.0 

.0 

.0 

1408.5 

1723.3 

2013.1 

2270.6 

3211.2 

3380.6 

3473.5 

1456.1 

1780.5 

2078.4 

2342.1 

3304.2 

3475.6 

3566.7 

1540.9 

1850.5 

2132.2 

2379.6 

3301.7 

3470.0 

3561.8 

1490.6 

1792.0 

2066.8 

2309.2 

3212.5 

3379.0 

3472.5 

-0 

.0 

.0 

.0 

.0 

.0 

.0 
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APPENDIX  G 

SAMM  "TSTl.TPa"  OUTPUT  HLE 
(EXCERPTS  FROM  TEST  CASE  1) 


-1P9- 


APPENDIX  G 


CARD  1  7 
CARD  2  *****  0 
CARD  2C  *****  33 


MODEL  ATMOSPHERE  NO 


MODEL  0  / 


.000  9.987E-01 
•OOOE+OO  .OOOE+00 
.OOOE+00 

1.000  8.847E-01 
.OOOE+OO  .OOOE+OO 
.OOOE+OO 

2.000  7.313E-01 
.OOOE+OO  .OOOE+OO 
.OOOE+OO 

3.000  6.879E-01 
.OOOE+OO  .OOOE+OO 
.OOOE+OO 


50.000  7.a06E-04 
.OOOE+OO  .OOOE+OO 
.OOOE+OO 

70.000  5.120E-05 
.OOOE+OO  .OOOE+OO 
.OOOE+OO 

100.000  3.135E-07 
.OOOE+OO  .OOOE+OO 
.OOOE+OO 


SAMM  "TST1.TP6''  OUTPUT  FILE 
(EXCERPTS  FROM  TEST  CASE  1) 


000000001  0  -000  .0500 

0  0  3  0  0  .000  .000  .000  .000  .000 

1  0 

7  ICLD  =  0 


7  USER  INPUT  DATA 


2.882E+02 

.OOOE+OO 

.OOOE+OO  .OOOE+OO 
.OOOE+OO  7.644E+09 

.OOOE+OO 

.OOOE+OO 

BABBB68B8BS888 

.OOOE+OO  .OOOE+OO 

2.817E+02 

.OOOE+OO 

.OOOE+OO  .OOOE+OO 
.OOOE+OO  6.939E+09 

.OOOE+OO 

.OOOE+OO 

3AB8B888B8B888 

, OOOE+OO  .OOOE+OO 

2.752E+02 

.OOOE+OO 

.OOOE+OO  .OOOE+OO 
.OOOE+OO  6.282E+09 

.OOOE+OO 

.OOOE+OO 

BA8868B868888B 

.OOOE+OO  .OOOE+OO 

2.687E+02 

.OOOE+OO 

.OOOE+OO  .OOOE+OO 
.OOOE+OO  S.673E+09 

.OOOE+OO 

.OOOE+OO 

BABBB88B88BBBB 

.OOOE+OO  .OOOE+OO 

2.706E+02 

.OOOE+OO 

.OOOE+OO  .OOOE+OO 
.OOOE+OO  2.200E+08 

.OOOE+OO 

.OOOE+OO 

BAB888B888B868 

.OOOE+OO  .OOOE+OO 

2.196E+02 

•OOOE+OO 

.OOOE+OO  .OOOE+OO 
.OOOE+OO  1.981E+07 

.OOOE+OO 

.OOOE+OO 

BAB86BBBBBBB8B 
.OOOE+OO  .OOOE+OO 

1.951E+02 

.OOOE+OO 

.OOOE+OO  .OOOE+OO 
.OOOE+OO  7.224E+07 

.OOOE+OO 

.OOOE+OO 

BAB6B88B88BBBB 

.OOOE+OO  .OOOE+OO 

-no- 


z 

P 

T 

REL  H 

H20 

CLO  AMT 

RAIH  RATE 

AEROSOL 

CICM) 

(MB) 

(K) 

(X) 

<GH  M-3) 

(GM  M-3) 

(MM  HR-1)  TYPE 

PROFILE 

,000 

1011.933 

288.20 

.00 

.OOOE+00 

.OOOE't'OO 

.0006+00  USER  RAIM 

NO  CLOUD 

USER  RAIN 

NO  CLOUD 

1-000 

896,422 

281,70 

.00 

.OOOE+00 

.OOOE+00 

.OOOE+00  USER  RAIN 

NO  CLOUD 

USER  RAIN 

NO  CLOUD 

2.000 

791.652 

275.20 

.00 

.OOOE+00 

.OOOE-^OO 

.OOOE+00  USER  RAIN 

NO  CLOUD 

USER  RAIN 

NO  CLOUD 

3,000 

*  ♦ 

697.015 

* 

268.70 

.00 

.OOOE+00 

.OOOE+00 

.OOOE+00  USER  RAIN  NO  CLOUD 

USER  RAIN 

NO  CLOUD 

SPRING -SUMMER 

50-000 

.791 

270.60 

.00 

.OOQE-^00 

.OOOE+OO 

.0006+00  USER  RAIN  NO  CLOUD 

USER  RAIN 

NO  CLOUD 

SPRING-SUMMER 

70.000 

.052 

219.60 

.00 

.OOOE+00 

.OOOE^^OO 

.0006+00  USER  RAIN 

NO  CLOUD 

USER  RAIN 

NO  CLOUD 

SPRING-SUMMER 

100.000 

.000 

195.10 

.00 

.OOOE-fOO 

.00OE-»OO 

.0006+00  USER  RAIN 

NO  CLOUD 

USER  RAIN 

NO  CLOUD 

SPRING-SUMMER 

CARD  3  *****  100.000 

.000 

.000 

.000 

.000  6371.000 

0 

360.000 

65.000 

.000  .000  -90.00 

CARD  4  *•*•*  1500 

4000 

1 

1 

PROGRAM  WILL  COMPUTE  RADIANCE 


ATMOSPHERIC  MOOEL 

TEMPERATURE  =  7 

WATER  VAPOR  =  7 

OZONE  =  7 

H4  =  0  MS  =  0  M6  =  0  MDEF  =  0 

SPACE  TO  SPACE  LIMB  PATH 

HMIN  =  100.000  ICM 


FREQUENCY  RANGE 

I VI  =  1500  CM-1  (  6.67  MICROMETERS) 

IV2  =  4000  CM-1  (  2.50  MICROMETERS) 

IDV  =:  1  CH-1 

IFWHM  -  1  CM-1 
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ATHOSPHERIC  PROFILES 


I 


1 

2 

3 

4 


2 

p 

T 

N2 

CNTHSLF  MOL  SCAT 

N-1 

03  (UV) 

02  (UV) 

(KM) 

(MB> 

CK) 

(M0L/CM2  KM)  (-) 

(-)  (ATM  CM/KM) 

(ATM  CM/K> 

-00 

1011.933 

288.2 

7.188E-01 

.OOOE+OO  9.465E-01 

2.723E-04 

.OOOE+OO 

.OOOE+OO 

1.00 

896.422 

281.7 

5.837E-01 

.OOOE+OO  8.578E-01 

2.468E-04 

.OOOE+OO 

.OOOE+OO 

2.00 

791.652 

275.2 

4.714E-01 

.OOOE+OO  7.755E-01 

2.231E-04 

.OOOE+OO 

.OOOE+OO 

3.00 

697.015 

268.7 

3-788E-01 

.OOOE+OO  6.993E-01 

2.012E-04 

.OOOE+OO 

.OOOE+OO 

«  * 


* 


31 

50.00 

.791 

270.6 

4.826E-07 

32 

70.00 

.052 

219-6 

2.840E-09 

33 

100.00 

.000 

195.1 

1.272E-13 

.OOOE+00  7.880E-04  2.267E-07  .OOOE+00 
•OOOE+OO  6.369E-05  1.832E-08  .OOOE+00 
.OOOE+00  4.389E-07  1.263E*10  .OOOE+OO 


.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


ATMOSPHERIC  PROFILES 


I 

2 

P 

T 

CNTMFRN 

HN03 

(KM) 

(MB) 

(K) 

M0L/CM2  KM 

ATM  CM/KM 

1 

.00 

1011.933 

288.2 

.OOOE+OO 

.OOOE+OO 

2 

1.00 

896.422 

281.7 

.OOOE+OO 

.OOOE+OO 

3 

2.00 

791.652 

275.2 

.OOOE+OO 

.OOOE+OO 

4 

3.00 

697.015 

268.7 

.OOOE+OO 

.OOOE+OO 

* 

*  ♦ 

31 

50.00 

.791 

270.6 

.OOOE+OO 

.OOOE+OO 

32 

70.00 

.052 

219.6 

.OOOE+OO 

.OOOE+OO 

33 

100.00 

.000 

195.1 

.OOOE+OO 

.OOOE+OO 

AEROSOL  2  AEROSOL  3  AEROSOL  4 
(-)  (-)  (-) 


AEROSOL  1 

<o 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


.OOOE+OO 
.OOOE+OO 
, OOOE+OO 
.OOOE+OO 


.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


AER1*RH 

(O 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


CIRRUS 

<-) 

.OOOE-OO 

.OOOE-00 

.OOOE-OO 

.OOOE-OO 


RH 

(PERCNT) 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


.OOOE+OO 

.OOOE+OO 

.OOOE+OO 


.OOOE+OO  .OOOE+OO 
.OOOE+OO  .OOOE-OO 
.OOOE+OO  .OOOE+OO 


ATHOSPHERIC  PROFILES 


I 

2 

P 

T 

H20 

(KM) 

(MB) 

<K)  ( 

1 

.00 

1011-933 

288.2 

.OOE+OO 

2 

1.00 

896.422 

281.7 

.OOE+OO 

3 

2.00 

791.652 

275.2 

.OOE+OO 

4 

3.00 

697.015 

268.7 

.OOE+OO 

03 

C02 

CO 

CH4 

N20 

ATM 

CM/KM 

OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

,  OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

,  OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

02 

NH3  NO 

N02 

OOE+OO 

.OOE+OO  2.84E-05 

.OOE+OO 

OOE+OO 

.OOE+OO  2.58E-05 

.OOE+OO 

.OOE+OO 

.OOE+OO  2.34E-05 

.OOE+OO 

.OOE+OO 

.OOE+OO  2.1 IE-05 

.OOE+OO 

31 

50.00 

.791 

270.6 

.OOE+OO 

32 

70.00 

.052 

219.6 

.OOE+OO 

33 

100.00 

.000 

195.1 

.OOE+OO 

OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

.OOE+OO 

OOE+OO 

•OOE+OO 

.OOE+OO 

•OOE+OO 

.OOE+OO 

.OOE+00  .OOE+OO  8.18E-07  .OOE+00 
.OOE+00  .OOE+OO  7.37E-08  .OOE+OO 
.OOE+OO  .OOE+OO  2.69E-07  .OOE+OO 


S02 

) 

OOE+OO 
OOE+OO 
OOE+OO 
.OOE+OO 


.OOE+OO 

.OOE+OO 

.OOE+OO 
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GEOMIN: 


SUMMARY 


THE  ENTIRE  PATH  LIES  ABOVE  THE  TOP  ZMAX  Of  THE  ATMOSPHERIC  PROFILE 

ZMAXS  =  30.0000  HI  =  300.0000  H2  =  300.0000  HHIN  =  99.9995 


OF  THE  GEOMETRY  CALCULATION 


H1 

= 

300.000 

iCM 

H2 

S 

300.000 

KM 

ANGLE 

= 

104.065 

DEG 

RANGE 

= 

3242.471 

KM 

BETA 

28.131 

DEG 

PHI 

104.065 

DEG 

HMIN 

100.000 

KM 

BENDING 

.000 

DEG 

lONGl 

= 

329,339 

DEG 

WEST  OF  GREENWICH 

LAT1 

= 

61 .538 

DEG 

NORTH  OF  EQUATOR 

PSIPO 

= 

-62.473 

DEG 

EAST  OF  NORTH 

L0NG2 

30.661 

DEG 

WEST  OF  GREENWICH 

UT2 

61 .538 

DEG 

NORTH  OF  EQUATOR 

LEN 

1 

I ERROR  =-9 
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OPTICAL  PATH  CUMULATIVE  AMOUNTS  TO  LAYER  L 


LAY  ALT  LAT  LONG  HERZBERG  TEMPERATURE  DEPENDENT  03  UV  TEMP  DEPENDENT  CNTMSLF1  CNTMSLF2  CNTHFRN 

L  (KM)  (degN)  (degW)  UV  02  02  PARAMETERS  (ATM-CM)  03  PARAMETERS  (  M0L/CM2  ) 

0  300.000  61.538  329.339 

1  290.000  61.697  329.990  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00 

2  280.000  61.858  330.665  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00 

3  270.000  62.020  331.368  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00 

*  ♦  ★ 

82  280.000  61.858  29.335  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+00  .OOOE+OO 

83  290.000  61.697  30.010  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO 

84  300.000  61.538  30.660  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .0006+00  .OOOE+OO  .OOOE+OO 


.OOOE-^00 

.OOOE+OO 

.0006+00 

.0006+00 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.0006+00 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.0006+00 

.OOOE+OO 

.OOOE+OO 

OPTICAL  PATH  CUMULATIVE  AMOUNTS  TO  LAYER  L 

LAY  ALT  LAT  LONG  N2  CONT  MOLEC  AER  1 

L  <OI)  (degN)  (degW)  (ATM-CM)  SCAT  0-2lcm 


AER  2  AER  3  AER  4  CIRRUS  TEMPERATURE  DEPENDENT 
2-lOlaii  10-301cm  30-1001cni  CLOUDS  RAIN  PARAMETERS 


0  300.000  61.538  329.339 

1  290.000  61.697  329.990  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO 

2  280.000  61.858  330.665  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO 

3  270.000  62.020  331.368  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .0006+00  .OOOE+OO  .OOOE+OO 


82  280.000  61.858  29.335  2.078E-11  7.174E-05  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO 

83  290.000  61.697  30.010  2.078E-11  7.174E-05  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .0006+00  .OOOE+OO  .OOOE+OO 

84  30o!oO0  61.538  30.660  2.078E-11  7.174E-05  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .OOOE+OO  .0006+00  .OOOE+OO  .OOOE+OO 
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OPTICAL  PATH  IHCREHENTAL  AHOUHTS  FROM  LAYER  L-1  TO  LAYER  L  (ATH-CM) 


LAY 

ALT 

LAT 

LONG 

TBAR 

H20C161) 

H20(181) 

H20<171) 

H20<162) 

C02(626) 

C02C636) 

C02(628) 

03 

N20 

L 

<KM) 

CdegM) 

(degW) 

(K) 

0 

300.000 

61.538 

329.339 

1 

290.000 

61.697 

329.990 

972.385 

.OOOE+00 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE-fOO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

2 

280.000 

61.858 

330.665 

966.630 

.OOOE^OO 

.OOOE'^OO 

.OOOE+OO 

.OOOE+OO 

.OOOE-^00 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

3 

270.000 

*  *  * 

62.020 

331.368 

960,370 

.OOOE+00 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

82 

280.000 

61.858 

29.335 

960.370 

.OOOE^-00 

.OOOE+OO 

, OOOE+OO 

-OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

83 

290.000 

61,697 

30.010 

966.630 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE'^00 

.OOOE+OO 

.OOOE+OO 

84 

300.000 

61.538 

30.660 

972.885 

.OOOE-^OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

TOTAL 

ABSORBER 

AMOUNT 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

•OOOE+OO 

OPTICAL  PATH 

INCREMENTAL  AMOUNTS  FROM  LAYER  L-1  TO 

LAYER  L 

(ATM -CM) 

LAY 

ALT 

LAT 

LONG 

CO 

CH4 

02 

NO 

S02 

N02 

NH3 

HN03 

OH 

N0+ 

L 

(KM) 

CdegN) 

(degW) 

0 

300.000 

61.538 

329.339 

1 

290.000 

61.697 

329.990 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

7.821E-10 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.  OOOE+OO 

.OOOE+OO 

2 

280.000 

61.858 

330.665 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

1.222E-09 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

3 

270.000 

«>  *  * 

62.020 

331.368 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

1.909E-09 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

,  OOOE+OO 

.OOOE+OO 

82 

280.000 

61.858 

29.335 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

1.909E-09 

. OOOE+OO 

.OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

83 

290.000 

61 .697 

30.010 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

1.222E-09 

, OOOE+OO 

.OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

84 

300.000 

61.538 

30.660 

, OOOE+OO 

.OOOE+OO 

.OOOE+OO 

7.821E-10 

, OOOE+OO 

-OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO 

TOTAL  ABSORBER 

AMOUNT 

.OOOE+OO 

.OOOE+OO 

.OOOE+OO  5.196E-04 

.OOOE+OO 

-OOOE+OO 

-OOOE+OO 

.OOOE+OO 

.OOOE+OO  7.386E-06 
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RAD  I ANCE<WATTS/CM2-STER-XXX) 


FREQ 

UAVLEN 

ATMOS  RADIANCE 

INTEGRAL 

TOTAL 

(CM-1) 

(MI CRN) 

<CM-1) 

(MICRN) 

(CM-1) 

TRANS 

1500- 

6.667 

2.37E-12 

5.34E’10 

1.19E-12 

1.0000 

1501. 

6.662 

4.57E-13 

1.03E-10 

1.64E-12 

1.0000 

1502. 

6.658 

1.71E-12 

3.85E-10 

3.35E-12 

1.0000 

1503. 

6.653 

3.51E-18 

7.92E-16 

3-35E-12 

1.0000 

1504. 

6.649 

3.28E-12 

7-42E-10 

6.63E-12 

1.0000 

1505. 

6.645 

2-62E-12 

5.93E-10 

9.25E-12 

1.0000 

*  1 

k  * 

3995. 

2.503 

6.02E-35 

9.61E-32 

5.92E-07 

1.0000 

3996. 

2.503 

5.88E-35 

9.38E-32 

5.92E-07 

1.0000 

3997. 

2-502 

5.73E-35 

9.16E-32 

5.92E-07 

1.0000 

3998. 

2.501 

5.60E-35 

8.95E-32 

5.92E-07 

1.0000 

3999. 

2.501 

4.37E-35 

6.98E-32 

5-92E-07 

1.0000 

4000. 

2.500 

4.26E-35 

6.82E-32 

5.92E-07 

1.0000 

INTEGRATED  ABSORPTION  FROM  1500  TO  4000  CM-1  =  .07  CH-1 

AVERAGE  TRANSMITTANCE  =1.0000 


INTEGRATED  RADIANCE  =  5.921E-07  WATTS  CM-2  STER-1 

MINIMUM  RADIANCE  =  .OOOE+00  WATTS  CM-2  STER-1  (CM-1)-1  AT  3174.0  CM-1 

MAXIMUM  RADIANCE  =  5.873E-09  WATTS  CM-2  STER-1  (CM-1)-1  AT  1847.0  CH-1 

CARD  5  *****  0 
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APPENDIX  H 

COLUMN  DENSITY  CALCULATION  UPGRADE 
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APPENDIX  H 


COLUMN  DENSITY  CALCULATION  UPGRADE 


H.l  Introduction 


The  Air  Force  atmospheric  radiative  transport  codes  FASCODE,  MODTRAN,  and 
MOSART  use  the  same  general  approach  to  calculate  column  densities  and  path  averages  over 
refractive  path  segments.  The  atmosphere  is  defined  by  specifying  densities  at  a  series  of 
boundary  altitudes,  and  densities  are  modeled  as  varying  exponentially  with  altitude  between 
boundaries.  For  this  stratified  atmosphere,  layer  column  densities  must  be  calculated  for  paths 
at  various  zenith  angles.  Unless  the  path  is  strictly  vertical,  densities  do  not  vary  exponentially 
with  path  length  due  to  the  curvature  of  the  earth  and  refraction. 

Accurate  column  densities  are  calculated  by  sub-dividing  the  path  within  a  layer  into 
short  sub-segments.  For  each  sub-segment,  the  density  at  the  end  points  is  determined  by 
exponentially  interpolating  over  altitude,  and  the  column  density  is  calculated  assuming  density 
varies  exponentially  with  path  length  for  the  short  segment.  In  MODTRAN,  the  sub-segments 
have  a  maximum  length  of  5  km.  A  half-tangent  path  of  this  length  has  a  change  in  altitude  of 
less  than  2  meters.  MODTRAN  species  densities  do  not  vary  significantly  over  such  small 
changes  in  altitude. 

The  above  prescription  for  calculating  column  densities,  although  accurate,  can  be  quite 
clumsy.  Typically,  the  calculation  of  sub-segment  column  densities  is  embedded  in  the 
refractive  geometry  module;  this  is  necessary  for  determination  of  intermediate  altitudes  and 
path  lengths.  Paths  for  which  column  densities  are  being  calculated  are  distinguished  from 
paths  being  used  simply  to  define  a  complete  set  of  line-of-sight  parameters.  For  each  species, 
the  layer  scale  heights  are  pre-calculated  to  expedite  calculation  of  end  point  densities.  The 
final  module  is  quite  complex. 

A  problem  can  also  arise  from  the  sub-segment  approach  when  path  averages  are 
calculated.  Occasionally  the  range  within  a  layer  can  approach  zero.  Since  the  range  cannot 
easily  be  factored  from  the  column  density  expression  if  the  sub-segment  approach  used,  a 
zero  divide  error  can  result. 

In  this  appendix,  an  accurate  approach  is  presented  for  calculating  the  column  densities 
through  a  single  layer  without  sub-dividing  the  layer  into  short  sub-segments.  The  upgraded 
column  density  expression  is 
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Cupgx^le  =  -^  I  x  )  ^  |  g- x  ( 2  , 


P2  S 


(H-1) 


where 


S  cos^i  Pi  ^  (Ri  +  R2  +  S  cos^i)  (AR  -  S  cos^i)  Pi 

""  4AR  ^  8R1  AR 


(H-2) 


S  cos6^  Pi  ,  (Ri  +  R2  -  S  cos^  (S  cos6*2  -  AR)  pi 
^  ^  "  4  AR  8R2  AR 

Inputs  are  (Figure  H-1)  the  path  length  S  and  the  earth  center  distances  Rj  and  R2,  the  zenith 
angles  di  and  ^2>  the  densities  pj  and  P2  at  the  beginning  and  end  of  the  path;  AR  is  the 
change  in  altitude,  R2  -  Ri-  The  derivation  of  these  equations  is  presented  in  Sections  H.2  and 
H.3.  Special  cases  are  examined  in  Section  H.4.  An  algorithm  for  numerically  evaluating  the 
integrals  appearing  in  Equation  (H-1)  is  presented  in  Section  H.5.  General  properties  of 
Upgrade  discussed  in  Section  H.6.  Section  H.7  contains  a  sample  calculation  and 
conclusions.  The  upgraded  approach  is  found  to  be  at  least  as  accurate  as  MODTRAN’s 
implementation  of  the  sub-segment  approach  for  path  segments  encountered  using  MODTRAN 
model  atmospheres. 
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H.2  Curved  Earth  Column  Density  Upgrade 


For  the  flat  earth  with  no  refraction  and  constant  scale  height,  density  varies 
exponentially  with  path  length.  Under  these  conditions,  column  density  is  readily  calculated: 

s 

=  Cf  j  WPi)"®  <!■'  («-<) 

0 


P\'  Pi 
ln(Pi//)2)  ' 


(H-5) 


Introduction  of  the  curved  earth  and  refraction  complicates  the  problem.  The  exact  expression 
for  column  density  assuming  exponential  variation  of  density  with  altitude  is 
s 

=  Pi  I  (P2/Pi/-'“<ia  ,  (H-6) 

0 

where  AR  is  the  increase  in  altitude  from  point  1  to  point  2  and  r^  is  the  increase  a  distance  a 
along  the  segment,  Figure  H-1.  For  vertical  paths  r^/AR  equals  a/S,  but  not  in  general.  The 
goal  here  is  to  find  a  better  approximation  for  r^/AR  so  that  column  densities  can  be  calculated 
more  accurately. 

With  simple  manipulations,  the  exact  column  density  expression  can  be  put  in  the  form 
s/2  S/2 

=  Pi  f  <P2'Pt)'-™  <1P  +  P2  j  (Pl/P2)‘“  ■  ^  ■  <H-7) 

0  0 

If  there  was  no  refraction  and  the  flat-earth  approximation  was  assumed,  r^  would  simply 
equal  a  cos^^,  where  6^  is  the  zenith  angle  illustrated  in  Figure  H-1,  and  Equation  (H-4)  would 
result.  Throughout  the  IR  to  UV  spectral  range,  the  curvature  of  the  earth  affects  atmospheric 
path  lengths  more  than  refraction.  Therefore,  as  a  first  level  of  improvement,  r^.  and  AR-rs.^ 
can  be  replaced  by  their  curved  earth  forms: 


=  '\/Ri2  -f-  2  a  Rj  cos^i  -1-  (t2  .  Rj 

(H-8) 

CURVED  EARTH 

=  R2  -  V^R2"  -  2ffR2COS02  +  0^  , 

(H-9) 

where  R^  and  R2  are  the  distance  from  points  1  and  2  to  the  earth  center,  respectively. 
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With  MODTRAN  standard  layering  structure,  the  longest  single  layer  half-tangent  path 
is  the  path  tangent  to  70  km  and  extending  up  to  100  km.  Above  70  km  refraction  is 
negligible,  and  this  longest  single  layer  path  is  less  than  a  tenth  of  the  earth  center  distance. 
Thus,  for  path  segments  encountered  in  MODTRAN,  r^  and  AR  -  rg.^  can  be  expanded  in 
powers  of  cr/R  as 


=  cr  [  cos^i  +  7  +  0(-^)  ] 

^  -  rs-(7  =  [  COS02  “  7  ^  sin202  +  ^ 


(H-10) 

(H-11) 


Here,  0(x)  is  used  to  denote  terms  of  order  x. 
Defining  the  constants 


S  cosdi  Pi 
^  4  AR  P2 

cr 

11 

sin20i  ^  Pi 

8R1  AR  ^“p2 

(H-12) 

S  COS^2  P 1 

AB  *" 

4  AR  P2 

11 

S-  sm%  ,  Pi 
8R2AR  *"p2  ’ 

CURVED  EARTH 

(H-13) 

and  dropping  second  order  terms  from  Equations  (H-10)  and  (H-11),  the  curved  earth  column 
density  has  the  form 


Pi  S 
2 


j  g-x(2ai  +bi2x)jjx  +  J  g-x(2a2  +b22x)jjx 


(H-14) 


'-'Upgrade 

Whenever  b^^  and  b2^  are  both  positive,  the  column  density  can  be  expressed  in  terms  of  error 
functions  of  real  arguments: 


C„pg«de  =  ^  I  {  b7  [  ®rf(b7+bi)  -  erf(-g^)  ] 


+  ^  f  ^  ^  ’  *>-1,5-2  >  0  ,  (H-15) 

where  erf(x)  is  the  error  function  of  x.  When  the  b^  parameters  are  zero,  the  integrals  reduce 

to  simple  exponentials,  and  when  these  parameters  are  negative,  the  lesser  known  Dawson 

integrals  (Table  7.5  of  Reference  1)  result.  Note  that  b^^  and  b2^  will  generally  both  be 
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non-negative;  however,  they  will  be  negative  if  there  is  a  density  inversion  (i.e.  if  R2  exceeds 
Rj^  but  P2  is  greater  than  Pi,  then  AR  =  R2  ■  R^  is  positive  and  ln(pj/p2)  is  negative). 

H.3  Curved  Earth  and  Path  Column  Density  Upgrade 

In  the  previous  section,  expressions  were  derived  for  r^  and  AR  -  rs.^^  for  the  curved 
earth  assuming  refiractive  affects  could  be  ignored  as  a  first  level  of  approximation.  In  this 
section,  the  expressions  are  re-derived  with  refraction  taken  into  account  in  an  approximate 
way.  This  is  accomplished  by  replacing  the  straight  line  path  from  point  1  to  2,  Figure  H-1, 
with  a  curved  path,  Figure  H-2.  For  approximating  r^,  the  curved  path  is  taken  to  be  the 


Figure  H-2.  Curved  Layer  Segment  From  Point  1  to  Point  2. 
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circular  arc  of  length  S,  tangent  to  the  line-of-sight  at  point  1  and  a  distance  R2  from  the  earth 
center  at  point  2.  The  roles  of  point  1  and  point  2  are  reversed  for  approximating  AR  -  rs.,^. 

Let  d  be  the  straight  line  distance  from  point  1  to  point  2  in  Figure  H-2.  Then  the 
equation  for  Li,  the  radius  of  curvature  at  point  1,  as  a  function  of  R^,  R2,  6^,  and  S  can  be 
derived  from  the  relationships 

=  Rj2  +  +  2  Ri  d  cos(0i  +  ,  and 

d  _  T  •  S 
2  -  L,  sm  -Jl;-  . 

Switching  subscripts  1  and  2,  expressions  for  L2,  the  radius  of  curvature  about  point  2,  result. 
Expanding  in  powers  of  S/L^  and  S/L2,  the  first  order  expressions  for  the  radii  of  curvature 
are 


(H-16) 

(H-17) 


Rj  sin^i  Rj-  +  +  2  Rj  S  cos^j  -  R2“  S  (S  +  4  Rj  cos0j)  ^ 


T  2 


(H-18) 


Ro  sin^-^  R'2*  4*  2  R-^  S  cos^  •  Ri^  S  (S  4  R^  cos^o) 

-  -  2  _  — L  +  o[ - -r - . 


^2 


S2 


L,2 


(H-19) 


As  should  be  expected,  the  radii  of  curvature  go  to  infinity  for  straight  paths.  The  upgraded 
expressions  for  r^  and  AR-rs.^^  are 


+  2aRjCOS0j  +  a2  -  a^Rjsin^j/Lj  +  ff(ff+4R2COS0i)O(a2/Lj2)  -  Rj 


1  „  (Rj  +  R,  +  S  cos^i)  (AR  -  S  cos^i) 

=  <t[cos9,  +  j(^) - = - - - J 

+  »  [  0(-^)  +  0(-4t)  1  (H-20) 

Rl“  Rj  Lj- 


1  Q  (Rj  +  -  S  cos^i)  (S  COS02  -  AR) 

^  -  2  ^ ^ - 1 


(H-21) 
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For  the  curved  earth  and  path,  a  and  b  constants  have  the  values 


S  COS0,  p,  .  (Ri  +  +  S  cos^i)  (AR  -  S  cos^i)  Pi 

=  W  '» - ~  srTar - '"ft 


(H-22) 


32  - 


S  COSfl2  Pi 


4AR  (h 


In^  b2"  = 


(Ri  +  R2  -  S  cosB^  (S  cos^  -  AR)  pj 


8R,  AR 


In- 


P2 


(H-23) 


The  expressions  for  column  density.  Equations  (H-14)  and  (H-15),  remain  the  same;  only  the 
values  of  the  and  b2^  parameters  change. 

For  the  straight  path,  \>i  and  b2^  are  non-negative  as  long  as  there  is  no  density 
inversion.  This  remains  true  for  the  curved  path  only  if  S  cos02  ^  R2  '  ^1  -  ^  cos^j.  For 
the  flat  earth,  the  three  terms  are  equal.  Due  to  the  curvature  of  the  earth,  S  cose2  >  R2  -  Ri 
>  S  cos^i  for  straight  paths.  As  long  as  earth  curvature  affects  dominate  refractive  affects, 
the  inequalities  remain  valid. 


H.4  Special  Cases 

The  upgraded  column  density  expression  is  evaluated  for  three  special  cases:  vertical 
paths,  short  half-limb  paths,  and  paths  to  space  with  a  constant  scale  height  atmosphere  (total 
column  densities).  Refraction  is  ignored  for  the  special  cases  2  and  3,  and  there  is  assumed  to 
be  no  density  inversions.  For  this  section  only,  the  subscript  "upgrade"  is  dropped  from 

n 

^upgrade* 

H.4.1  CASE  1:  Vertical  Paths 


For  vertical  paths,  sin^^  =  sin02  =  AR  =  ±S. 

Substituting  into  Equations  (H-12)  and  (H-13)  or  Equations  (H-22)  and  (H-23),  both  b 
parameters  are  zero,  and  a^  =  ■^ln(p]L/p2)  =  -  a2.  With  the  b  parameters  equal  to  zero,  C  is 
most  easily  evaluated  directly  from  Equation  (H-14).  The  result. 


Pi  -P2 

^vertical  -  S  ln(pj/p^ 


(H-24) 


is  identical  to  the  flat-earth  approximation.  Equation  (H-3),  as  it  should  be  for  a  vertical  path. 
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H.4.2  CASE  2:  No  Refraction,  No  Density  Inversion,  Short  Half-Limb  Path 

For  a  half-limb  path  tangent  at  point  1,  cos^i  =  0,  sin^j  =  1,  cos02  =  S/R2,  and 
sm62  =  R1/R2.  If  the  path  length  is  small  compared  to  Rj,  then  Rj  »  R2  and  2AR  »  S^/Rj. 
With  this  level  of  approximation,  the  half-tangent  a  and  b  parameters  equal 

aj  =  0,  32  =  -  Y  In— ,  bj- =  b2^  =  Y  short  half-limb  .  (H-25) 

Remembering  that  erf(x)  =  -  erf(-x).  Equation  (H-15)  reduces  to 

;  Vln(p,/P2)  (H-26) 

=  ^,S(i-lan^)  +  ^an^)^  +  O[0n^)’jl  .  (H-27) 

The  leading  order  correction  to  p^S  for  Csj^ort  haif-iimb  is  different  from  the  leading  order 
correction  for  Cflat-earth-  Setting  P2  to  pj  (1  -  e),  equals 

=  Pi  S  [  1  -  Y  +  0(^)  ]  ,  (H-28) 


while  Cshort  half-limb  equals 


Cshort  half-limb  =  Pi  s  [  1  - 1  -K  0(e2)  ]  ,  (H-29) 

The  deviation  from  p^S  is  less  for  the  short  half-limb  expression. 

H.4.3  CASE  3:  Total  Column  Density  with  Constant  (>0)  Scale  Height  and  No  Refraction 

In  this  case,  the  total  column  density  is  calculated  as  a  function  of  zenith  angle  for 
0°  <  61  <  90°.  Since  r^  and  AR-fs.^  were  both  expanded  assuming  S/Rj  and  S/R2  were 
small,  it  might  seem  inappropriate  to  consider  the  S  -*  «  limit.  However,  if  the  scale  height 
D  is  small  compared  to  the  earth  center  distance  R^,  then  the  major  contribution  to  the  column 
density  comes  from  that  part  of  the  line-of-sight  for  which  S/R^  is  small. 
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The  scale  height  is  defined  by  the  relationship 


D  =  AR  /  ln(— )  .  (H-30) 

P2 

The  law  of  sines  bounds  the  sine  of 
R  R 

sin62  =  sindi  <  .  (H-31) 

K2  K2 


Noting  that  R2  »  AR 

»  S  as  S  ^  00,  the  a  and  b  parameters  equal 

S  cos^i 
“  4D 

,  sin20i 

”  SRjD 

S  LARGE 

(H-32) 

s 

S  sih2e2  Rr 

^  ~  8D 

^  "  ~Jd 

(H-33) 

Since  b2  goes  to  zero  as  S  approaches  infinity,  the  column  density  integral  about  distant 
point  2  can  be  evaluated  directly  from  Equation  (H-14): 

«  1 

0 


=  Iimits_oo  D  pi  [  e’  ®  ^  ^  -  e‘  ^  ^  ®  ]  =  0  . 


(H-34) 


The  contribution  from  the  far  side  of  the  line-of-sight  is  zero,  consistent  with  the  density 
falling  off  exponentially.  The  integral  about  point  1  is  evaluated  using  Equation  (H-15). 
Since  limits_oo  (^ti/bj  +  bj)  approaches  infinity  for  any  between  0  and  90  degrees 
inclusive,  the  first  error  function  in  Equation  (H-15)  goes  to  1,  The  total  column  density 
expression  reduces  to 


limits_o,  CC^i)  =  VT 


xDpi 

sin^i 


exp(  X"  ctn“0i )  erfc(  x  ctn0j )  , 


(H-35) 


where  2  x^  =  Rj  /  D  and  erfc  is  the  complementary  error  function.  The  normalized  total 
column  density  is  plotted  as  a  function  of  zenith  angle  in  Figure  H-3;  the  scale  height  was  set 
equal  to  Rj/IOOG,  a  reasonable  value  for  total  density  above  the  earth’s  surface.  The  flat-earth 
approximation  is  recovered  for  equal  to  zero  degrees: 
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ZENITH  ANGLE,  (DEG) 

Figure  H-3.  Variation  in  Total  Column  Density  With  Zenith  Angle.  Scale  Height  was 
Chosen  Equal  to  the  Earth’s  Radius  Over  1000. 

limits^,  €(^1=0°)  =  Dpi  .  (H-36) 

At  6 1  equal  60°,  Equation  (H-36)  gives  twice  the  flat-earth  approximation,  and  for  the 
half-limb  calculation  (0i  =  90°)  almost  40  times  the  flat-earth  value  results: 

limits^,.  C(0,  =90°)  =  Vtt  Rj  D  /  2  pj  .  (H-37) 

To  demonstrate  that  Equation  (H-37)  is  reasonable,  the  no  refraction  half-limb  integral 
can  be  evaluated  exactly.  Combining  Equations  (H-6),  (H-8),  and  (H-30)  with  6i  =  90°  and 
letting  the  path  length  S  approach  infinity,  the  no  refraction  total  column  density  equals 

oo 

C«„dsl.bdf-li„.b  =  Pi  p"'®  )  “P(  -  i  VrTTT")  dff  .  (H-38) 

0 
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Substituting  a  =  Rj  sinh(t),  the  integral  representation  of  a  modified  Bessel  function, 
Equation  9.6.24  of  Reference  1,  results 

^straight  half-limb  =  ^1  .  (H-39) 

The  asymptotic  expansion  (Equation  9.7.2  of  Reference  1)  gives 

^straight  half-Iimb  ~  "V/x  Ri  D  /  2  Pi  {  ^  ”  "g  }  ’  (H-40) 

in  agreement  with  Equation  (H-37). 

H.5  Numerical  Evaluation  of  the  Column  Density 

Calculation  of  the  upgraded  expression  for  column  density  requires  evaluation  of  the 
integral 

1 

I(a,b2)  =  j  +  "^>dx  (H-41) 

0 

for  arbitrary  real  a  and  b^.  In  terms  of  I(a,b^),  the  column  density  equals 

^  I(a„b,-)  +  ^  I(a2.b2-)  .  (H-42) 

Evaluation  is  performed  by  dividing  the  b^  domain  of  I(a,b^)  into  three  regions. 

H.5.1  Region  1:  b^  >  0.0001 

'y 

Throughout  this  subsection,  b  is  defined  as  the  positive  square  root  of  b"^.  For  positive 
b^,  I(a,b^)  can  be  expressed  in  terms  of  error  functions  of  real  arguments: 

I(a,b^)  =  ^  exp  [  erf(|-  +  b)  -  erf(|-)  ]  .  (H-43) 

Evaluation  is  facilitated  by  working  with  the  complementary  error  function  of  non-negative 
arguments.  Three  sub-cases  arise: 
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I(a,b2)  =  W  2V 

fora>0  , 

(H-44a) 

I(a,b2)  =  erfc(-  -^)  -  erfc(-  ], 

fora+b"<0  , 

(H-44b) 

I(a,b2)  =  -/7^e'^"^'[2-erfc(-^)-erfc(--^)], 

otherwise  . 

(H-44c) 

Defining  J(z,b)  by 

J(z,b)  =  ^  erfc(|-)  , 

(H-45) 

Equations  (H-44a)  through  (H-44c)  become 

I(a,b2)  =  J(a,b)  -  J(a+lr,b), 

fora>0  , 

(H-46a) 

I(a,b2)  =  J(-a-b2,b)  -  J(-a,b), 

fora+b^<0  , 

{H-46b) 

I(a,b2)  =  J(a+lr,b)  -  J(-a,b), 

otherwise  , 

(H-46c) 

For  0  <  z  <  1.883  b,  J(z,b)  is  evaluated 

using  a  rational 

approximation, 

Equation  7. 1.26  of  Reference  1: 

Qfi  +  01:2 1  +  a3  t^  +  04 1^  +  of5  t^ 

=  b  +  p  z 

(H-47) 

where 

t  =  1— ^ —  p  =  +0.3275911 

b  +  p  z  ^ 

ai  =  +0.225836846  a2  =  -0.252128668 

03  =  +1.259695129  04  =  -1.287822453  05  =  +0.940646070  . 

For  z  >  1.883  b,  J(z,b)  can  be  calculated  from  a  truncated  continued  fraction, 

Equation  7.1.14  of  Reference  1  (the  continued  fraction  notation  from  Reference  1  has  been 
adopted): 
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z/b+  z/b+  z/b+  z/b+  z/b+  z/b+  z/b+  z/b+  z/b 


(H-48a) 


8  +  140  u  +  690  iP  +  975  u3  +  192 
z  (16  +  288  u  +  1512  iP  +  2520  +  945  u^) 


(H-48b) 


where  u  =  b^/z^.  The  cutoff  between  the  two  expressions  was  set  to  z/b  =  1.883  because 
the  rational  approximation  and  continued  fraction  cross  at  that  value.  Reference  1  indicates 
that  the  maximum  absolute  error  in  the  rational  approximation  for  erfc(x)  is  1.5  x  10"'.  With 
b  >  0.01,  the  maximum  possible  absolute  error  for  Equation  (H-47)  is  4.6  x  10"^ 
[=  0.5  VTexp(L883^)  (1.5  x  10'^)  /  0.01].  At  this  maximum  (b=0.01,  z=0.01883),  J(b,z) 
equals  23.8  corresponding  to  a  relative  error  of  1.9  x  10'^.  The  actual  calculation  at  b=0.01, 
z=0.01883  using  Equation  (H-47)  results  in  a  relative  error  of  1.14  x  10'^. 

H.5.2  Region  2;  jb^l  <  0.0001 


^  2  2 

For  |b^|  <  0.0001,  I(a,b^)  can  be  evaluated  by  expanding  e‘°'^’from 

Equation  (H-33)  in  a  power  series.  If  2  |a|  <  .01,  the  full  exponential  e '  ^  ^can  be 

expanded.  The  results  are 


I(a,b2)  =  ^  { (1  -  e-2^)  -  [1  -  e-2^  (1  +  2  a  +  2  a^)] }  +  0(b'‘) 

z  a  7,  2r 


(H-49) 


„  .  .  2a2-lP  2a3-3ab2 

I(a,b-)  =  1  -  a  + 3 - ^ 


+  0[(2a)^]  +  0[(2a)-bi  +  0[b^] 


(H-50) 


H.5.3  Region  3:  b^  <  -  0.0001 

Let  i8  be  defined  equal  to  >  0.  Substituting  y=jSx-a/i8  in  Equation  (H-41), 

I(a,-iS^)  equals 


l8-a//3 


I(a,-;8^)  =  J  j  dy  . 


(H-51) 


Defining  F(x)  as  the  Dawson  integral 
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(H-52) 


X 

F(x)  s  ^  dy  , 

0 

I(a,-/3^)  can  be  written 


I(a,-|82)  = 

1 

-  F(-|-)], 

fora<0  , 

(H-53a) 

I(a, -|82)  = 

1 

iS 

[F(|)  -  e^'-2«F(|-^)], 

fora>|8^  , 

(H-53b) 

= 

1 

13 

[e^^-2“F03-|-)  +  F(|)], 

otherwise  . 

(H-53c) 

The  Dawson  integral  can  be  evaluated  by  linearly  interpolating  the  tabulated  values  from 
Reference  1  (Table  7.5). 

H.6  General  Properties 

Calculating  the  colunm  density  between  two  points  in  space  should  give  the  same 
answer  in  either  direction.  Also,  adding  a  layer  boundary  at  an  altitude  R  between  R,  and  R^ 
should  not  change  the  column  density  if  the  intermediate  density  p  is  defined  by  exponentially 
interpolating  and  P2  over  altitude. 

For  both  Cflat^earth  ^upgrade,  the  column  density  is  indeed  independent  of  direction 

(H-54) 

^upgrade^2’^l’^2’^l’^'^2’^”^l)  ■  (H-55) 

For  C^pgradej  Switching  direction  switches  the  values  of  a^  and  a2  and  the  values  of  b^-  and  b,^ 
(when  direction  is  switched,  the  sign  of  AR  and  ln(pi/p2)  changes  but  S  is  always  positive). 
Equation  (H-55)  follows  from  the  defining  expression  for  C^pg^ade^  Equation  (H-14). 

Adding  an  intermediate  layer  only  approximately  conserves  column  density 

^upgrade 

®  C„pg„de(Pl,^;Rl,R2;^l’^2)  >  (H-56) 


where 
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Ri  <  R  <  R2,  and 

The  relationship  is  not  exact,  because  the  exponents  in  Equation  (H-8)  were  approximated 
using  truncated  power  series.  The  deviation  from  conservation  will  be  less  for  the  column 
density  upgrade  than  for  the  flat  earth  expression  since  improved  approximations  for  the 
exponents  were  used. 

H.7  Conclusions 


The  goal  of  this  effort  was  to  demonstrate  that  atmospheric  column  densities  for 
refractive  path  segments  with  constant  scale  heights  could  be  calculated  without  having  to 
sub-divide  each  segment  into  short  sub-segments.  The  prescription  laid  out  requires  input  of 
the  path  length  and  the  density,  earth  center  distance  and  zenith  angle  at  the  beginning  and  end 
of  each  path  segment  (for  spherically  symmetric  atmospheres,  the  product  of  the  earth  center 
angle,  the  sine  of  the  zenith  angle  and  the  index  of  refraction  is  a  path  constant,  implying  that 
the  zenith  angle  need  not  be  an  independent  input).  Using  Equations  (H-2)  and  (H-3),  the 
constants  a^,  a2,  bj^  and  b2^  are  calculated.  Column  density  is  then  determined  from 
Equation  (H-42).  Section  H.4  describes  the  routine  used  to  calculate  the  I(a,b^)  integrals. 

An  example  illustrates  the  accuracy  of  the  above  prescription.  MODTRAN  column 
densities  were  calculated  for  a  line-of-sight  from  the  ground  (R^  =  6371.23  km)  to  1  km 
altitude  (R2  =  6372.23  km)  with  an  initial  zenith  angle  of  90°  and  using  the  US  Standard 
Atmosphere.  The  calculations  were  run  at  0.55  /tm.  Water’s  density  changed  most  drastically 
over  this  altitude  range,  dropping  from  733.29  atm  cm/km  to  521.76  atm  cm/km.  Path  range 
was  determined  to  be  123.749  km  and  the  zenith  angle  at  H2  is  89.071°.  The  flat  earth 
approximation  predicts  a  column  density  for  water  of 

Cfiat  earth  =  76914.  atm  cm  [5.6%] 

(the  absolute  percent  error  is  in  brackets).  In  MODTRAN,  the  123.749  km  path  is 
sub-divided  into  27  sub-segments  and  the  flat  earth  approximation  is  applied  to  each  of  them: 

Cmodtnm  =  81425.  atm  cm  [-0.008%]  . 
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If  the  a  and  b  parameters  for  a  straight  path  and  curved  earth,  Equations  (H-12)  and  (H-13), 
are  used  to  calculate  the  column  density,  considerable  improvement  over  the  flat-earth 
approximation  results, 

path)  =  80971.  atm  cm  [0.57%]  ; 

however,  refraction  is  significant  at  0.55  nm  for  this  path.  Using  the  parameters  defined  by 
Equations  (H-2)  and  (H-3),  the  column  density  was  recalculated 

Cupgj^e(curved  path)  =  81435.  atm  cm  [0.004%]  . 

A  benchmark  value  was  determined  by  calculating  the  curved  path,  curved  earth  column 
density  for  each  of  MODTRAN’s  27  sub-segments.  The  result  is 

^benchmark  =  81431.5  atm  Cm. 

For  long  paths  like  the  one  just  discussed,  the  upgraded  expression  for  column  density 
requires  less  computational  time  than  required  to  exponentially  interpolate  densities  at  each  of 
26  intermediate  boundaries.  However,  the  processing  time  for  the  geometry  calculation  in 
radiative  transport  codes  is  usually  small.  The  true  advantage  of  the  approach  presented  here 
is  that  it  eliminates  the  necessity  of  sub-dividing  each  path  segment  into  sub-segments  for 
calculation  of  column  densities. 
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